Skip to main content

Serval

Handle IT tickets and track access requests in Serval.

Tools

402 available tools

Search the tool definitions captured from the MCP server. The live list can vary with version, deployment, and credentials.

402 tools found.

  • Add entity type field

    Tool name: add_entity_type_field

    Deprecated: use POST /v2/entity-type-fields.

  • Add label to app instance

    Tool name: add_label_to_app_instance

    DEPRECATED: use AddTagToSubject.

  • Add tag to subject

    Tool name: add_tag_to_subject

    Attach a tag to a subject (resource, role, app instance, workflow, or guidance).

  • Add ticket assignment group

    Tool name: add_ticket_assignment_group

    Add a group to the team's configured assignment groups.

  • Add ticket relevant asset

    Tool name: add_ticket_relevant_asset

    Add a relevant asset to a ticket.

  • Aggregate entities

    Tool name: aggregate_entities

    Aggregate live-entity counts for one entity schema (database), grouped by entity type or by creation-time bucket (day or month).

  • Archive entity

    Tool name: archive_entity

    Archive an entity, hiding it from active browse while keeping its key reserved so the key cannot be reused.

  • Archive ticket

    Tool name: archive_ticket

    Move a ticket into cold storage, removing it from most views.

  • Await workflow run result

    Tool name: await_workflow_run_result

    Block until the workflow run reaches a terminal status or wait_timeout_seconds elapses.

  • Batch create app resources

    Tool name: batch_create_app_resources

    Create multiple app resources for an app instance in a single request.

  • Batch get review items

    Tool name: batch_get_review_items

    Read before and after documents for 1–20 unique item IDs from one review, in request order.

  • Batch update app resource roles

    Tool name: batch_update_app_resource_roles

    Update multiple app resource roles in a single transactional request.

  • Batch update app resources

    Tool name: batch_update_app_resources

    Update multiple app resources in a single transactional request.

  • Bulk add label to app instances

    Tool name: bulk_add_label_to_app_instances

    DEPRECATED: use AddTagToSubject per app instance.

  • Bulk remove label from app instances

    Tool name: bulk_remove_label_from_app_instances

    DEPRECATED: use RemoveTagFromSubject per app instance.

  • Cancel schema migration

    Tool name: cancel_schema_migration

    Cancel a still-pending schema migration.

  • Connect ticket to external ticket

    Tool name: connect_ticket_to_external_ticket

    Connect an existing Serval ticket to an existing external ticket in a sync channel.

  • Count workflow runs

    Tool name: count_workflow_runs

    Count workflow runs matching the same filters as Search Workflow Runs (workflow ID, status, user IDs, time range, linked ticket, parent run, include_child_runs, include_runs_with_linked_ticket).

  • Create access policy

    Tool name: create_access_policy

    Create a new access policy for a team.

  • Create access policy approval procedure

    Tool name: create_access_policy_approval_procedure

    Create a new approval procedure for an access policy.

  • Create access profile

    Tool name: create_access_profile

    Create a new access profile for a team.

  • Create access profile grant

    Tool name: create_access_profile_grant

    Attach an access profile to a workflow, app resource role, or form.

  • Create access relationship

    Tool name: create_access_relationship

    Create an access relationship on a subject (app instance, resource, role, or team).

  • Create access request

    Tool name: create_access_request

    Create an access request for a role.

  • Create agent

    Tool name: create_agent

    Create a new agent.

  • Create app instance

    Tool name: create_app_instance

    Create a new app instance for a team.

  • Create app instance label

    Tool name: create_app_instance_label

    DEPRECATED: use the Tag API.

  • Create app relationship

    Tool name: create_app_relationship

    DEPRECATED: use CreateAccessRelationship.

  • Create app resource

    Tool name: create_app_resource

    Create a new app resource for an app instance.

  • Create app resource role

    Tool name: create_app_resource_role

    Create a new app resource role for a resource.

  • Create approval delegation

    Tool name: create_approval_delegation

    Create a new approval delegation rule.

  • Create approval procedure

    Tool name: create_approval_procedure

    Create a named, team-scoped approval procedure.

  • Create assignment rule

    Tool name: create_assignment_rule

    Create an assignment rule on a team.

  • Create category option

    Tool name: create_category_option

    Create a category (or subcategory) for a team.

  • Create change blackout schedule

    Tool name: create_change_blackout_schedule

    Create a one-off change-blackout window during which changes are frozen.

  • Create custom field option

    Tool name: create_custom_field_option

    Create a custom field definition on a team's ticket type.

  • Create custom role

    Tool name: create_custom_role

    Create a custom role on a team.

  • Create custom service

    Tool name: create_custom_service

    Create a new custom service for a team.

  • Create database rule

    Tool name: create_database_rule

    Create a rule on a table.

  • Create entity

    Tool name: create_entity

    Create a new entity for a team.

  • Create entity field mapping

    Tool name: create_entity_field_mapping

    Create a field mapping binding an external source field (from an ingestion config's discovered external schema) to an internal entity-type field.

  • Create entity ingestion config

    Tool name: create_entity_ingestion_config

    Create an entity ingestion config that links a workflow to an entity type for periodic data synchronization.

  • Create entity type

    Tool name: create_entity_type

    Create a new entity type with optional fields for a team.

  • Create entity type field

    Tool name: create_entity_type_field

    Create a field on an entity type.

  • Create folder

    Tool name: create_folder

    Create a folder to organize folder items.

  • Create form

    Tool name: create_form

    Create a form for a team from module source (TSX importing "serval/forms").

  • Create group

    Tool name: create_group

    Create a new group.

  • Create guidance

    Tool name: create_guidance

    Create a new guidance for a team.

  • Create help agent simulation

    Tool name: create_help_agent_simulation

    Run a help-agent simulation from a saved simulation config.

  • Create help agent simulation config

    Tool name: create_help_agent_simulation_config

    Create a saved help-agent simulation config (a reusable evaluation scenario).

  • Create knowledge base

    Tool name: create_knowledge_base

    Create a native knowledge base for a team.

  • Create knowledge document

    Tool name: create_knowledge_document

    Create a knowledge document (page or folder).

  • Create label

    Tool name: create_label

    Create a ticket label for a help-desk team.

  • Create reclamation candidate

    Tool name: create_reclamation_candidate

    Flag an entitlement grant for reclamation now, on your own logic, without waiting for the inactivity sweep.

  • Create schedule

    Tool name: create_schedule

    Create a recurring schedule for a team.

  • Create sla definition

    Tool name: create_sla_definition

    Create an SLA definition for a team.

  • Create status

    Tool name: create_status

    Create a ticket status for a team.

  • Create tag

    Tool name: create_tag

    Create a new tag.

  • Create team

    Tool name: create_team

    Create a new team.

  • Create team group

    Tool name: create_team_group

    Bind a group to a team with a specified role.

  • Create team user

    Tool name: create_team_user

    Add a user to a team with a specified role.

  • Create ticket

    Tool name: create_ticket

    Create a new ticket.

  • Create ticket external messages

    Tool name: create_ticket_external_messages

    Register Serval messages as already present in an external channel.

  • Create ticket message

    Tool name: create_ticket_message

    Create a new message in a ticket.

  • Create ticket model field

    Tool name: create_ticket_model_field

    Add a custom field to a ticket model.

  • Create ticket model transition

    Tool name: create_ticket_model_transition

    Create a transition in a ticket model.

  • Create ticket subscribers

    Tool name: create_ticket_subscribers

    Add subscribers to a ticket.

  • Create user

    Tool name: create_user

    Create a new user.

  • Create user relationship

    Tool name: create_user_relationship

    Create or update a user relationship.

  • Create workflow

    Tool name: create_workflow

    Create a new workflow for a team.

  • Create workflow approval procedure

    Tool name: create_workflow_approval_procedure

    Create a new approval procedure for a workflow.

  • Delete access policy

    Tool name: delete_access_policy

    Delete an access policy.

  • Delete access policy approval procedure

    Tool name: delete_access_policy_approval_procedure

    Delete an approval procedure for an access policy.

  • Delete access profile

    Tool name: delete_access_profile

    Delete an access profile.

  • Delete access profile grant

    Tool name: delete_access_profile_grant

    Delete an access profile grant, detaching the profile from the resource.

  • Delete access relationship

    Tool name: delete_access_relationship

    Delete an access relationship.

  • Delete agent

    Tool name: delete_agent

    Delete an agent.

  • Delete app instance

    Tool name: delete_app_instance

    Delete an app instance.

  • Delete app instance label

    Tool name: delete_app_instance_label

    DEPRECATED: use the Tag API.

  • Delete app relationship

    Tool name: delete_app_relationship

    DEPRECATED: use DeleteAccessRelationship.

  • Delete app resource

    Tool name: delete_app_resource

    Delete an app resource.

  • Delete app resource role

    Tool name: delete_app_resource_role

    Delete an app resource role.

  • Delete approval delegation

    Tool name: delete_approval_delegation

    Delete an approval delegation rule.

  • Delete approval procedure

    Tool name: delete_approval_procedure

    Delete an approval procedure.

  • Delete assignment rule

    Tool name: delete_assignment_rule

    Delete an assignment rule.

  • Delete category option

    Tool name: delete_category_option

    Delete a category and its subcategories.

  • Delete change blackout schedule

    Tool name: delete_change_blackout_schedule

    Delete a change-blackout schedule.

  • Delete custom role

    Tool name: delete_custom_role

    Delete a custom role.

  • Delete custom service

    Tool name: delete_custom_service

    Delete a custom service.

  • Delete database rule

    Tool name: delete_database_rule

    Delete a workflow or validation rule from a table.

  • Delete entity

    Tool name: delete_entity

    Delete an entity.

  • Delete entity field mapping

    Tool name: delete_entity_field_mapping

    Delete a field mapping.

  • Delete entity ingestion config

    Tool name: delete_entity_ingestion_config

    Delete an entity ingestion config.

  • Delete entity type

    Tool name: delete_entity_type

    Delete an entity type.

  • Delete entity type field

    Tool name: delete_entity_type_field

    Delete an entity type field.

  • Delete entity workflow rule

    Tool name: delete_entity_workflow_rule

    Delete a workflow rule.

  • Delete folder

    Tool name: delete_folder

    Delete a folder.

  • Delete form

    Tool name: delete_form

    Delete a form.

  • Delete group

    Tool name: delete_group

    Delete a group.

  • Delete guidance

    Tool name: delete_guidance

    Delete a guidance.

  • Delete help agent simulation config

    Tool name: delete_help_agent_simulation_config

    Delete a saved help-agent simulation config.

  • Delete knowledge base

    Tool name: delete_knowledge_base

    Delete a knowledge base and all of its documents.

  • Delete knowledge document

    Tool name: delete_knowledge_document

    Delete a knowledge document and its descendants.

  • Delete label

    Tool name: delete_label

    Delete a ticket label.

  • Delete sla definition

    Tool name: delete_sla_definition

    Delete an SLA definition.

  • Delete status

    Tool name: delete_status

    Delete an unused, non-default ticket status.

  • Delete tag

    Tool name: delete_tag

    Delete a tag.

  • Delete team

    Tool name: delete_team

    Delete a team.

  • Delete team group

    Tool name: delete_team_group

    Remove a group's role binding from a team.

  • Delete team user

    Tool name: delete_team_user

    Remove a user from a team.

  • Delete ticket model status entry action

    Tool name: delete_ticket_model_status_entry_action

    Delete a status entry action wiring.

  • Delete ticket model transition

    Tool name: delete_ticket_model_transition

    Delete a ticket model transition.

  • Delete ticket subscribers

    Tool name: delete_ticket_subscribers

    Remove a subscriber from a ticket.

  • Delete user

    Tool name: delete_user

    Delete a user.

  • Delete user relationship

    Tool name: delete_user_relationship

    Delete a user relationship.

  • Delete workflow

    Tool name: delete_workflow

    Delete a workflow.

  • Delete workflow approval procedure

    Tool name: delete_workflow_approval_procedure

    Delete an approval procedure for a workflow.

  • Deprecate ticket model field

    Tool name: deprecate_ticket_model_field

    Deprecate a custom field on a ticket model.

  • Disconnect ticket from external ticket

    Tool name: disconnect_ticket_from_external_ticket

    Disconnect a Serval ticket from an external sync channel.

  • Dismiss database issue

    Tool name: dismiss_database_issue

    Resolve an issue by closing every open occurrence.

  • Dismiss reclamation candidate

    Tool name: dismiss_reclamation_candidate

    Dismiss an in-review reclamation candidate: conclude its review as dismissed, leaving the grant in place.

  • Get access policy

    Tool name: get_access_policy

    Get a specific access policy by ID.

  • Get access policy approval procedure

    Tool name: get_access_policy_approval_procedure

    Get a specific approval procedure by ID for an access policy.

  • Get access profile

    Tool name: get_access_profile

    Get a specific access profile by ID.

  • Get access profile grant

    Tool name: get_access_profile_grant

    Get a specific access profile grant by ID.

  • Get access relationship

    Tool name: get_access_relationship

    Get a specific access relationship by ID.

  • Get access request

    Tool name: get_access_request

    Get a specific access request by ID.

  • Get agent

    Tool name: get_agent

    Get an agent by ID.

  • Get agent session

    Tool name: get_agent_session

    Get an agent run's current state.

  • Get agent session transcript

    Tool name: get_agent_session_transcript

    Get the full transcript of an agent session — every message and the actions (tool calls) the agent took, in order.

  • Get app instance

    Tool name: get_app_instance

    Get a specific app instance by ID.

  • Get app instance agent card

    Tool name: get_app_instance_agent_card

    Get the A2A agent card discovered for a connected external agent app instance: the agent's name, description, and advertised skills.

  • Get app relationship

    Tool name: get_app_relationship

    DEPRECATED: use GetAccessRelationship.

  • Get app resource

    Tool name: get_app_resource

    Get a specific app resource by ID.

  • Get app resource role

    Tool name: get_app_resource_role

    Get a specific app resource role by ID.

  • Get approval delegation

    Tool name: get_approval_delegation

    Get an approval delegation rule by its ID.

  • Get approval procedure

    Tool name: get_approval_procedure

    Get a specific approval procedure by ID.

  • Get approval request

    Tool name: get_approval_request

    Get a single approval request by ID.

  • Get approval request step

    Tool name: get_approval_request_step

    Get a single step for an approval request.

  • Get assignment rule

    Tool name: get_assignment_rule

    Retrieve a single assignment rule by ID.

  • Get category option

    Tool name: get_category_option

    Get a category (or subcategory) by ID.

  • Get change blackout schedule

    Tool name: get_change_blackout_schedule

    Get a change-blackout schedule by id.

  • Get current user

    Tool name: get_current_user

    Get the current authenticated user's profile, including their organization role and team memberships with roles.

  • Get custom role

    Tool name: get_custom_role

    Get a custom role, including the actions it grants on top of its base role.

  • Get custom service

    Tool name: get_custom_service

    Get a specific custom service by ID.

  • Get custom service endpoint

    Tool name: get_custom_service_endpoint

    Return the full parameter list and request/response schemas for ONE endpoint of a custom app's uploaded API spec.

  • Get dashboard

    Tool name: get_dashboard

    Retrieve a single dashboard by ID, with its tabs and the widgets placed on each.

  • Get database issue

    Tool name: get_database_issue

    Get one issue on a table by its id, as returned by List database issues: its category, code and reason, when it was first and last observed, how many occurrences are open, and the details for its…

  • Get database rule

    Tool name: get_database_rule

    Get a workflow or validation rule on a table.

  • Get entity

    Tool name: get_entity

    Get a specific entity by ID.

  • Get entity field mapping

    Tool name: get_entity_field_mapping

    Get a field mapping by ID.

  • Get entity file

    Tool name: get_entity_file

    Get the metadata and a short-lived download URL for a file stored in an entity's file field.

  • Get entity ingestion config

    Tool name: get_entity_ingestion_config

    Get a specific entity ingestion config by ID.

  • Get entity ingestion config sync status

    Tool name: get_entity_ingestion_config_sync_status

    Get the sync status for an entity ingestion config, including last sync time, current phase, and data availability flags.

  • Get entity schema

    Tool name: get_entity_schema

    Get Entity Schema [Scope: team]

  • Get entity type

    Tool name: get_entity_type

    Get an entity type by ID.

  • Get entity type field

    Tool name: get_entity_type_field

    Get an entity type field by ID, including its enum options.

  • Get entity workflow rule

    Tool name: get_entity_workflow_rule

    Get a workflow rule.

  • Get external entity schema

    Tool name: get_external_entity_schema

    Get the external schema discovered from the most recent sync of an ingestion config.

  • Get folder

    Tool name: get_folder

    Get a single folder by ID.

  • Get form

    Tool name: get_form

    Get a specific form by ID, including the module source of the version currently shown in the builder (the latest draft, or the published version when there is no newer draft).

  • Get group

    Tool name: get_group

    Get a specific group by ID.

  • Get guidance

    Tool name: get_guidance

    Get a specific guidance by ID.

  • Get help agent form

    Tool name: get_help_agent_form

    Fetch a form the help-desk agent opened on a conversation, so it can be rendered and answered.

  • Get help agent simulation

    Tool name: get_help_agent_simulation

    Get the status or result of a help-agent simulation.

  • Get help agent simulation config

    Tool name: get_help_agent_simulation_config

    Get a saved help-agent simulation config including its scenario.

  • Get help agent simulation run

    Tool name: get_help_agent_simulation_run

    Inspect a recorded simulation run by its run UUID, including status, transcript and judge results.

  • Get help agent simulation suite

    Tool name: get_help_agent_simulation_suite

    Get a saved help-agent simulation suite, including its ordered member config ids.

  • Get help agent simulation suite run

    Tool name: get_help_agent_simulation_suite_run

    Inspect a recorded simulation suite run by its suite-run UUID.

  • Get journey

    Tool name: get_journey

    Fetch a single journey snapshot with tasks, health checks, and workflow failures.

  • Get knowledge base

    Tool name: get_knowledge_base

    Get a knowledge base by ID.

  • Get knowledge document

    Tool name: get_knowledge_document

    Get a knowledge document, including its body rendered as Markdown/plain text.

  • Get priority

    Tool name: get_priority

    Get a priority by ID.

  • Get review

    Tool name: get_review

    Read a review's source, apply state, and current approval requirement.

  • Get review item

    Tool name: get_review_item

    Read secret-scrubbed before and after documents using the review UI's comparison baseline.

  • Get schema migration

    Tool name: get_schema_migration

    Get a schema migration by ID, including its current status (PENDING, IN_PROGRESS, APPLIED, COMPLETED, FAILED, or CANCELLED).

  • Get sla definition

    Tool name: get_sla_definition

    Retrieve a single SLA definition by ID, including its conditions, attachment criteria, and action definitions.

  • Get sla statistics

    Tool name: get_sla_statistics

    Get aggregate SLA compliance statistics for a team — the same numbers the native Analytics -> SLA page shows: met/breached/active counts, compliance rate, and completion-time percentiles.

  • Get sla timeseries

    Tool name: get_sla_timeseries

    Get a per-day SLA outcome timeseries for a team — met, breached, and active-on-track counts bucketed by day over the window.

  • Get status

    Tool name: get_status

    Get a ticket status by ID.

  • Get tag

    Tool name: get_tag

    Get a specific tag by ID.

  • Get team

    Tool name: get_team

    Get a specific team by ID.

  • Get team assignment settings

    Tool name: get_team_assignment_settings

    Retrieve the Settings tab of the team's Assignment page: the assignment preferences (default member assignment, restriction to team members, custom escalation workflow) and the assignment groups with…

  • Get team group

    Tool name: get_team_group

    Get a specific team group binding by team ID and group ID, or by composite ID.

  • Get team user

    Tool name: get_team_user

    Get a specific team user by team ID and user ID, or by composite ID.

  • Get ticket

    Tool name: get_ticket

    Get a specific ticket by ID.

  • Get ticket custom field values

    Tool name: get_ticket_custom_field_values

    Get the custom field values that have been explicitly set on a ticket.

  • Get ticket model definition

    Tool name: get_ticket_model_definition

    Get a ticket model's full definition.

  • Get ticket relationship

    Tool name: get_ticket_relationship

    Get a ticket relationship by its ID.

  • Get ticket snapshot

    Tool name: get_ticket_snapshot

    Get an internal troubleshooting snapshot for a ticket.

  • Get ticket statistics

    Tool name: get_ticket_statistics

    Get a team's lifetime ticket activity — the same 'All time' numbers the native Analytics landing shows: AI-resolved tickets, AI-assisted tickets, total ticket-attached workflow runs, and median time…

  • Get ticket timeseries

    Tool name: get_ticket_timeseries

    Get a team's per-ticket time series over a window — creation and resolution timestamps and responded-feedback sentiment counts — the raw rows the native Analytics landing's requests, time-to-resolve,…

  • Get user

    Tool name: get_user

    Get a specific user by ID.

  • Get user custom fields schema

    Tool name: get_user_custom_fields_schema

    Get the organization's user custom fields schema — the custom attributes carried on every user (department, manager, etc.) beyond id/email, with each field's key, type, and valid ENUM/MULTI_SELECT…

  • Get user relationship

    Tool name: get_user_relationship

    Get a user's relationship of the given type (e.g. their manager).

  • Get widget

    Tool name: get_widget

    Retrieve a single widget by ID, with its type and the matching config.

  • Get workflow

    Tool name: get_workflow

    Get a specific workflow by ID.

  • Get workflow approval procedure

    Tool name: get_workflow_approval_procedure

    Get a specific approval procedure by ID for a workflow.

  • Get workflow run

    Tool name: get_workflow_run

    Get a specific workflow run by ID.

  • Get workflow run task

    Tool name: get_workflow_run_task

    Get the full (size-capped) input and output for a single task (step) of a workflow run.

  • Install change models

    Tool name: install_change_models

    Install ITIL change models for the team.

  • Install schema template

    Tool name: install_schema_template

    Install Schema Template [Scope: team]

  • Link tickets

    Tool name: link_tickets

    Link two tickets together with a linked relationship.

  • List access policies

    Tool name: list_access_policies

    List all access policies for a team.

  • List access policy approval procedures

    Tool name: list_access_policy_approval_procedures

    List all approval procedures for an access policy.

  • List access profile grants

    Tool name: list_access_profile_grants

    List access profile grants for a team, optionally filtered by access profile, resource type, or resource.

  • List access profiles

    Tool name: list_access_profiles

    List all access profiles for a team.

  • List access relationships

    Tool name: list_access_relationships

    List access relationships for a subject (app instance, resource, role, or team).

  • List access requests

    Tool name: list_access_requests

    List access requests for a team.

  • List agent sessions

    Tool name: list_agent_sessions

    List the sessions (executions) produced by an agent, most recent first.

  • List agents

    Tool name: list_agents

    List agents for a team.

  • List app instance integrations

    Tool name: list_app_instance_integrations

    List integrations for an app instance.

  • List app instance labels

    Tool name: list_app_instance_labels

    DEPRECATED: use the Tag API.

  • List app instances

    Tool name: list_app_instances

    List app instances owned by the team along with those shared with it.

  • List app relationships

    Tool name: list_app_relationships

    DEPRECATED: use ListAccessRelationships.

  • List app resource roles

    Tool name: list_app_resource_roles

    List all app resource roles for a team, optionally filtered by resource.

  • List app resources

    Tool name: list_app_resources

    List all app resources for a team, optionally filtered by app instance.

  • List approval delegations

    Tool name: list_approval_delegations

    List approval delegation rules.

  • List approval procedures

    Tool name: list_approval_procedures

    List a team's approval procedures.

  • List approval request steps

    Tool name: list_approval_request_steps

    List all steps for an approval request, including approver resolutions.

  • List approval requests

    Tool name: list_approval_requests

    List all approval requests for a team.

  • List assignment rules

    Tool name: list_assignment_rules

    List a team's assignment rules in precedence order, lowest display_order first.

  • List audit logs

    Tool name: list_audit_logs

    List your organization's audit log events from the last 90 days, newest first.

  • List category options

    Tool name: list_category_options

    List categories (including nested subcategories) for a team.

  • List change blackout schedules

    Tool name: list_change_blackout_schedules

    List the team's change-blackout schedules.

  • List change schedule conflicts

    Tool name: list_change_schedule_conflicts

    Read what's scheduled during a window and what each change collides with (CAB prep, blast-radius, find-a-window).

  • List connected channels

    Tool name: list_connected_channels

    List existing Slack and Microsoft Teams channel connections, including disabled channels.

  • List custom field options

    Tool name: list_custom_field_options

    List the available custom field definitions for a team and ticket type.

  • List custom roles

    Tool name: list_custom_roles

    List a team's custom roles.

  • List custom services

    Tool name: list_custom_services

    List all custom services for a team.

  • List database issue evidence

    Tool name: list_database_issue_evidence

    List the occurrences grouped into one issue, such as each failed workflow run or rejected item, newest first.

  • List database issues

    Tool name: list_database_issues

    List a table's open issues, most recently observed first: synced items a rule rejected or that failed to publish, sync and schema-migration failures, and workflow rule runs or held changes that did…

  • List database rules

    Tool name: list_database_rules

    List a table's workflow and validation rules.

  • List document templates

    Tool name: list_document_templates

    List the team's document-signing templates with the recipient roles, variables (tokens), and fillable fields a signature input references.

  • List email intake configs

    Tool name: list_email_intake_configs

    List the email addresses a team receives tickets through.

  • List entities

    Tool name: list_entities

    List entities for a team.

  • List entity field mappings

    Tool name: list_entity_field_mappings

    List the field mappings for an entity type, optionally narrowed to a single ingestion config's source.

  • List entity field value history

    Tool name: list_entity_field_value_history

    List the change history for an entity's field values.

  • List entity ingestion configs

    Tool name: list_entity_ingestion_configs

    List entity ingestion configs for a team, optionally filtered by app instance.

  • List entity ingestion runs

    Tool name: list_entity_ingestion_runs

    List the ingestion runs for an entity ingestion config, most-recent-first, including status, per-item counts, and any failure.

  • List entity pending changes

    Tool name: list_entity_pending_changes

    List changes to a table that before-workflow rules are holding until their workflows decide, with each run's state.

  • List entity schemas

    Tool name: list_entity_schemas

    List Entity Schemas [Scope: team]

  • List entity types

    Tool name: list_entity_types

    List all entity types for a team.

  • List entity workflow rules

    Tool name: list_entity_workflow_rules

    List workflow rules for an entity type.

  • List folder contents

    Tool name: list_folder_contents

    List the direct items in a folder.

  • List folders

    Tool name: list_folders

    List a team's folders of a given item_type as a flat list (use parent_folder_id to reconstruct the tree).

  • List forms

    Tool name: list_forms

    List a team's forms.

  • List groups

    Tool name: list_groups

    List groups.

  • List guidance versions

    Tool name: list_guidance_versions

    List the version history of a guidance (Help Desk Skill).

  • List guidances

    Tool name: list_guidances

    List all guidances for a team.

  • List help agent simulation configs

    Tool name: list_help_agent_simulation_configs

    List the team's saved help-agent simulation configs (without scenarios).

  • List help agent simulation runs

    Tool name: list_help_agent_simulation_runs

    List standalone simulation run history.

  • List help agent simulation suite runs

    Tool name: list_help_agent_simulation_suite_runs

    List recorded simulation suite runs, optionally filtered by suite_id.

  • List help agent simulation suites

    Tool name: list_help_agent_simulation_suites

    List the team's saved help-agent simulation suites (without membership).

  • List journeys

    Tool name: list_journeys

    List lean journey rows for a team.

  • List knowledge bases

    Tool name: list_knowledge_bases

    List the knowledge bases for a team.

  • List knowledge documents

    Tool name: list_knowledge_documents

    List the documents in a knowledge base.

  • List labels

    Tool name: list_labels

    List labels for a team.

  • List priorities

    Tool name: list_priorities

    List priorities for a team.

  • List reclamation candidates

    Tool name: list_reclamation_candidates

    List a team's reclamation-candidate reclamations — entitlement grants flagged for review or reclaim because the user stopped signing in.

  • List reports

    Tool name: list_reports

    List reports for a team.

  • List requestable roles

    Tool name: list_requestable_roles

    List roles that are available for requesting access.

  • List resources for app instance

    Tool name: list_resources_for_app_instance

    List Resources For App Instance [Scope: team]

  • List review items

    Tool name: list_review_items

    List review item metadata using page_size and page_token.

  • List reviews

    Tool name: list_reviews

    List a team's session reviews and incoming promotions, or use outgoing=true for promotions from that team.

  • List schedules

    Tool name: list_schedules

    List a team's recurring schedules.

  • List schema migrations

    Tool name: list_schema_migrations

    List the schema migration history for an entity type, newest first.

  • List schema templates

    Tool name: list_schema_templates

    List Schema Templates [Scope: team]

  • List sla definitions

    Tool name: list_sla_definitions

    List all SLA definitions for a team.

  • List statuses

    Tool name: list_statuses

    List statuses for a team.

  • List subject tags

    Tool name: list_subject_tags

    List the tags attached to a subject.

  • List tags

    Tool name: list_tags

    List all tags for a team.

  • List team access policy approval procedures

    Tool name: list_team_access_policy_approval_procedures

    List all access policy approval procedures for a team.

  • List team groups

    Tool name: list_team_groups

    List team group bindings.

  • List team users

    Tool name: list_team_users

    List team users.

  • List team workflow approval procedures

    Tool name: list_team_workflow_approval_procedures

    List all workflow approval procedures for a team.

  • List teams

    Tool name: list_teams

    List all teams.

  • List ticket assignment groups

    Tool name: list_ticket_assignment_groups

    List the groups tickets on this team can be routed to.

  • List ticket external messages

    Tool name: list_ticket_external_messages

    List all origin external messages for a ticket.

  • List ticket external tickets

    Tool name: list_ticket_external_tickets

    List all external tickets linked to a Serval ticket.

  • List ticket feedback

    Tool name: list_ticket_feedback

    List feedback items across tickets for a team.

  • List ticket messages

    Tool name: list_ticket_messages

    List messages for a ticket.

  • List ticket model transitions

    Tool name: list_ticket_model_transitions

    List all ticket model transitions for the team.

  • List ticket models

    Tool name: list_ticket_models

    List the team's ticket models across all ticket types (journey, request, incident, ...).

  • List ticket relevant assets

    Tool name: list_ticket_relevant_assets

    List all relevant assets associated with a ticket.

  • List ticket sla instances

    Tool name: list_ticket_sla_instances

    List a team's SLA instances — one per SLA attachment to a ticket, carrying its definition ID, lifecycle state, clock timestamps, and progress snapshots.

  • List ticket subscribers

    Tool name: list_ticket_subscribers

    List all subscribers for a ticket.

  • List tickets

    Tool name: list_tickets

    List tickets for a team.

  • List topics

    Tool name: list_topics

    List the AI-generated topic taxonomy for a team.

  • List user phone numbers

    Tool name: list_user_phone_numbers

    List current phone assignments and their login trust.

  • List user relationships

    Tool name: list_user_relationships

    List user relationships.

  • List users

    Tool name: list_users

    List all users.

  • List worker egress failures

    Tool name: list_worker_egress_failures

    List connections the team's worker replicas could not open while running workflows, aggregated per replica, app instance, and cause (dns, timeout, refused, tls_untrusted, tls_hostname, tls_handshake,…

  • List worker replicas

    Tool name: list_worker_replicas

    List the team's worker replicas (worker processes, Serval-managed and self-hosted) that reported recently: hosting, chart version, image tags, queues, the config generation each was installed with,…

  • List workers

    Tool name: list_workers

    List the team's self-hosted (hybrid) workers — customer-run workers that serve app instances with route_direct_from_worker — with each worker's name, creation time, last connection to Serval, and…

  • List workflow approval procedures

    Tool name: list_workflow_approval_procedures

    List all approval procedures for a workflow.

  • List workflow run tasks

    Tool name: list_workflow_run_tasks

    List the tasks (steps) of a workflow run, ordered by step, with truncated input/output previews and a resolved outcome per step.

  • List workflow runs

    Tool name: list_workflow_runs

    List all workflow runs for a team, ordered by created_at desc.

  • List workflow versions

    Tool name: list_workflow_versions

    List the version history of a workflow.

  • List workflows

    Tool name: list_workflows

    List all workflows for a team.

  • Move knowledge document

    Tool name: move_knowledge_document

    Re-parent a knowledge document within its knowledge base, or move it to the top level.

  • Move ticket to team

    Tool name: move_ticket_to_team

    Move a ticket to a different team.

  • Notify user

    Tool name: notify_user

    Send an agent-run notification to a recipient the agent resolved in-session.

  • Preview schema template install

    Tool name: preview_schema_template_install

    Preview Schema Template Install [Scope: team]

  • Promote incident to major incident

    Tool name: promote_incident_to_major_incident

    Promote an incident in place to a major incident, recording the optional reason on the ticket's activity log and carrying existing custom-field values onto the major-incident field set.

  • Publish knowledge document

    Tool name: publish_knowledge_document

    Publish a knowledge document so it becomes agent-retrievable (kicks off indexing).

  • Put entity workflow rule

    Tool name: put_entity_workflow_rule

    Configure a workflow rule for entity changes.

  • Query change tickets

    Tool name: query_change_tickets

    Read the team's change tickets for fleet-level analysis.

  • Reactivate user

    Tool name: reactivate_user

    Reactivate a previously deactivated user, restoring their organization membership.

  • Reclaim reclamation candidate

    Tool name: reclaim_reclamation_candidate

    Reclaim an in-review reclamation candidate: conclude its review as reclaimed and start deprovisioning the grant.

  • Reclassify ticket

    Tool name: reclassify_ticket

    Reclassify a ticket in place between request and incident, recording the optional reason on the ticket's activity log.

  • Remove label from app instance

    Tool name: remove_label_from_app_instance

    DEPRECATED: use RemoveTagFromSubject.

  • Remove tag from subject

    Tool name: remove_tag_from_subject

    Detach a tag from a subject.

  • Remove ticket assignment group

    Tool name: remove_ticket_assignment_group

    Remove a group from the team's configured assignment groups.

  • Remove ticket relevant asset

    Tool name: remove_ticket_relevant_asset

    Remove a relevant asset from a ticket.

  • Reorder assignment rules

    Tool name: reorder_assignment_rules

    Set the order of a team's assignment rules.

  • Replay entity workflow

    Tool name: replay_entity_workflow

    Run an after-workflow rule's workflow again, with the change's captured values, for an execution that failed, was held, or was canceled.

  • Resolve scoped refs

    Tool name: resolve_scoped_refs

    Resolve team-scoped ids (wf_/skill_/ent_/form_) to their resource UUID, display name, and kind within a team.

  • Reveal entity field value

    Tool name: reveal_entity_field_value

    Reveal the value of a sensitive field on one entity.

  • Revoke access request

    Tool name: revoke_access_request

    Revokes an active access request, ending the user's access early.

  • Search access memberships

    Tool name: search_access_memberships

    List a user’s recorded Access Management role memberships within one team, matching the role Users rosters.

  • Search access requests

    Tool name: search_access_requests

    Search access requests with filters.

  • Search app resource roles

    Tool name: search_app_resource_roles

    Search app resource roles by role or parent-resource text, optionally filtered by team, app instance, or resource IDs.

  • Search app resources

    Tool name: search_app_resources

    Search app resources with filters in the request body.

  • Search approval requests

    Tool name: search_approval_requests

    Search approval requests with filters such as resource type, result status, and date range.

  • Search custom service endpoints

    Tool name: search_custom_service_endpoints

    Find endpoints in an OpenAPI spec the team uploaded for one of its custom HTTP apps.

  • Search entities

    Tool name: search_entities

    Search entities with advanced filtering, sorting, and pagination.

  • Search entity types

    Tool name: search_entity_types

    Search for entity types by key or other filters.

  • Search groups

    Tool name: search_groups

    Find groups by name.

  • Search knowledge

    Tool name: search_knowledge

    Search the team's knowledge corpus.

  • Search ticket messages

    Tool name: search_ticket_messages

    Search messages across tickets with filters for team, ticket, author, author role, and creation time range.

  • Search tickets

    Tool name: search_tickets

    Search tickets with filters.

  • Search users

    Tool name: search_users

    Search the organization's user directory with structured filters over built-in user fields AND user custom fields in one query — the same search that powers the Users database UI.

  • Search workflow runs

    Tool name: search_workflow_runs

    Search workflow runs with filters.

  • Send help agent message

    Tool name: send_help_agent_message

    Send a message to a team's help desk agent and wait for its reply.

  • Set assignment rules fallback

    Tool name: set_assignment_rules_fallback

    Replace the fallback, shown in the app as All other tickets: who is assigned a ticket that no assignment rule matches.

  • Set connected channel mode

    Tool name: set_connected_channel_mode

    Set the mode of an existing channel connection.

  • Set folder item location

    Tool name: set_folder_item_location

    Set the folder location for a folder item, or move it to the root by leaving folder_id unset.

  • Set ticket custom field values

    Tool name: set_ticket_custom_field_values

    Set custom field values on a ticket.

  • Set ticket model field hidden

    Tool name: set_ticket_model_field_hidden

    Set a ticket model custom field's default-hidden state.

  • Set ticket model lifecycle

    Tool name: set_ticket_model_lifecycle

    Set a ticket model's lifecycle statuses.

  • Set ticket model transition

    Tool name: set_ticket_model_transition

    Set a transition's auto-fire flag and/or its field-value preconditions.

  • Set ticket model transition precondition

    Tool name: set_ticket_model_transition_precondition

    Set or clear a transition's precondition.

  • Set user phone login trust

    Tool name: set_user_phone_login_trust

    Explicitly grant or revoke magic-link login trust for the current phone assignment.

  • Start help agent simulation

    Tool name: start_help_agent_simulation

    Run a published simulation config.

  • Start help agent simulation suite

    Tool name: start_help_agent_simulation_suite

    Run a published simulation suite.

  • Start workflow run

    Tool name: start_workflow_run

    Start a workflow asynchronously.

  • Submit help agent form

    Tool name: submit_help_agent_form

    Submit values for a form the help-desk agent opened.

  • Submit ticket feedback

    Tool name: submit_ticket_feedback

    Submit a user's feedback (CSAT) on a ticket.

  • Sync entity ingestion config

    Tool name: sync_entity_ingestion_config

    Trigger a sync for an entity ingestion config.

  • Sync ticket to channel

    Tool name: sync_ticket_to_channel

    Sync an existing Serval ticket to a channel by creating an external ticket in that channel and establishing ongoing bidirectional sync.

  • Trigger agent session

    Tool name: trigger_agent_session

    Trigger a manual run of an agent, outside its cron schedule.

  • Unarchive entity

    Tool name: unarchive_entity

    Restore an archived entity to active browse.

  • Unarchive ticket

    Tool name: unarchive_ticket

    Restore a ticket from cold storage.

  • Unpublish knowledge document

    Tool name: unpublish_knowledge_document

    Unpublish a knowledge document so it is no longer agent-retrievable.

  • Update access policy

    Tool name: update_access_policy

    Update an existing access policy.

  • Update access policy approval procedure

    Tool name: update_access_policy_approval_procedure

    Update an existing approval procedure for an access policy.

  • Update access profile

    Tool name: update_access_profile

    Update an existing access profile.

  • Update access relationship

    Tool name: update_access_relationship

    Update an access relationship.

  • Update agent

    Tool name: update_agent

    Update an agent.

  • Update app instance

    Tool name: update_app_instance

    Update an existing app instance.

  • Update app instance label

    Tool name: update_app_instance_label

    DEPRECATED: use the Tag API.

  • Update app relationship

    Tool name: update_app_relationship

    DEPRECATED: use UpdateAccessRelationship.

  • Update app resource

    Tool name: update_app_resource

    Update an existing app resource.

  • Update app resource role

    Tool name: update_app_resource_role

    Update an existing app resource role.

  • Update approval delegation

    Tool name: update_approval_delegation

    Update an existing approval delegation rule.

  • Update approval procedure

    Tool name: update_approval_procedure

    Replace an approval procedure's name, description, timeout, and steps.

  • Update assignment rule

    Tool name: update_assignment_rule

    Replace an assignment rule's conditions and actions.

  • Update category option

    Tool name: update_category_option

    Update a category's name, description, or parent.

  • Update change blackout schedule

    Tool name: update_change_blackout_schedule

    Update a one-off change-blackout schedule's description or window.

  • Update custom role

    Tool name: update_custom_role

    Update a custom role's name, description, base role, and granted actions.

  • Update custom service

    Tool name: update_custom_service

    Update an existing custom service.

  • Update database rule

    Tool name: update_database_rule

    Update a table rule.

  • Update entity

    Tool name: update_entity

    Update an existing entity.

  • Update entity field mapping

    Tool name: update_entity_field_mapping

    Update a field mapping's external field path and/or precedence.

  • Update entity ingestion config

    Tool name: update_entity_ingestion_config

    Update an entity ingestion config.

  • Update entity type

    Tool name: update_entity_type

    Update an entity type's name, color, icon, or help-agent visibility.

  • Update entity type field

    Tool name: update_entity_type_field

    Update an entity type field: rename it (set name) and/or change its data type (set data_type, plus enum_options when the new type is ENUM/MULTI_SELECT).

  • Update folder

    Tool name: update_folder

    Rename and/or move a folder.

  • Update form

    Tool name: update_form

    Update a form's draft.

  • Update group

    Tool name: update_group

    Update an existing group.

  • Update guidance

    Tool name: update_guidance

    Update an existing guidance.

  • Update help agent simulation config

    Tool name: update_help_agent_simulation_config

    Update a simulation config's name/description, or replace its scenario (which creates a new revision).

  • Update knowledge base

    Tool name: update_knowledge_base

    Update a knowledge base.

  • Update knowledge document

    Tool name: update_knowledge_document

    Update a knowledge document's title, content (Markdown), icon, or color.

  • Update label

    Tool name: update_label

    Update a ticket label's name, description, color, or whether the help-desk agent may apply it.

  • Update priority

    Tool name: update_priority

    Update a priority's display name, description, or AI selectability.

  • Update sla definition

    Tool name: update_sla_definition

    Update an SLA definition.

  • Update status

    Tool name: update_status

    Update a ticket status.

  • Update tag

    Tool name: update_tag

    Update an existing tag.

  • Update team

    Tool name: update_team

    Update an existing team.

  • Update team assignment settings

    Tool name: update_team_assignment_settings

    Change the team's assignment preferences.

  • Update team group

    Tool name: update_team_group

    Update the role a group holds on a team.

  • Update team user

    Tool name: update_team_user

    Update a team user's role.

  • Update ticket

    Tool name: update_ticket

    Update an existing ticket.

  • Update ticket assignment group

    Tool name: update_ticket_assignment_group

    Set an assignment group's work schedule or member assignment.

  • Update user

    Tool name: update_user

    Update an existing user.

  • Update workflow

    Tool name: update_workflow

    Update an existing workflow.

  • Update workflow approval procedure

    Tool name: update_workflow_approval_procedure

    Update an existing approval procedure for a workflow.

  • Upsert ticket model

    Tool name: upsert_ticket_model

    Create or update a ticket model.

  • Upsert ticket model status entry action

    Tool name: upsert_ticket_model_status_entry_action

    Wire a workflow to fire on status entry.

  • Wait for help agent messages

    Tool name: wait_for_help_agent_messages

    Follow a conversation for whatever the help-desk agent says next.

Compatibility

Connect Serval to the clients your teams already use

27 AI clients can connect to Serval through Runlayer. Pick one for its setup steps and controls.

Why Runlayer

Why connect Serval through Runlayer?

One approved path

Approve Serval once and everyone gets it in the AI clients they already use. Runlayer holds the credentials, so nothing sits in client configuration.

Fine-grained policy

Control who can use each server, tool, and resource, and under which runtime conditions.

Runtime security

Scan tool inputs and outputs for prompt injection, credential exposure, PII, and data exfiltration, then alert, mask, or block.

Audit and observability

Trace every request across users, clients, tools, policies, scanner decisions, and downstream systems.

Frequently asked questions