MCP tool reference

The platform MCP server provides 306 tools. They're listed here by category, in the order the server registers them. Each tool's full parameter list is sent to your MCP client when it connects, so your assistant sees the arguments and their descriptions directly.

All tools act in the project your API key belongs to, and are limited by the key's Access level. A tool that changes or runs something needs Write; some, such as deleting an agent, need Admin. See Authentication.

Agents

Agent configurations, one-shot runs, agent identity, context prompts and request contexts. 23 tools.

Tool	What it does
create_agent	Create a new AI agent configuration.
list_agents	List all agent configurations the current user has access to.
search_agents	Search agents by a specific field value.
get_agent	Retrieve full details of a single agent configuration by ID.
update_agent	Update an existing agent configuration — only the fields you pass are changed.
delete_agent	Permanently delete an agent configuration.
assign_functions_to_agent	Attach one or more tool functions to an agent.
remove_function_from_agent	Detach a tool function from an agent.
run_agent	Run a single agent once and return its response (synchronous).
run_agent_async	Start an asynchronous agent run, returning an execution_id to poll.
get_agent_run_status	Poll the status/result of an asynchronous agent run.
get_agent_identity	Get an agent's platform identity (service account) details.
set_agent_identity_active	Enable or disable an agent's platform identity.
create_context_prompt	Create a reusable context prompt.
list_context_prompts	List all context prompts.
get_context_prompt	Get a single context prompt by ID.
update_context_prompt	Update a context prompt's text.
delete_context_prompt	Delete a context prompt.
create_request_context	Create a request context record.
list_request_contexts	List all request contexts.
get_request_context	Get a single request context by ID.
update_request_context	Update a request context.
delete_request_context	Delete a request context.

Teams

Multi-agent teams and their membership. 10 tools.

Tool	What it does
create_team	Create a new multi-agent team.
list_teams	List all team configurations.
search_teams	Search teams by a field value.
get_team	Get full details of a team by ID, including its agents and settings.
update_team	Update a team configuration — only the fields you pass are changed.
delete_team	Permanently delete a team configuration.
add_agents_to_team	Add one or more agents to an existing team.
add_agent_to_team	Add a single agent to a team, optionally with a role override.
remove_agent_from_team	Remove an agent from a team.
update_agent_position_in_team	Change an agent's ordering position within a team.

LLM configs

Model connections that agents run on. 8 tools.

Tool	What it does
create_llm_config	Create an LLM configuration (model connection settings).
list_llm_configs	List all LLM configurations.
search_llm_configs	Search LLM configs by a field value.
get_llm_config	Retrieve a single LLM configuration by ID.
update_llm_config	Update an LLM configuration — only the fields you pass are changed.
delete_llm_config	Delete an LLM configuration.
get_resolved_llm_config	Get an LLM config with inherited/folder values fully resolved.
assign_functions_to_llm_config	Attach tool functions to an LLM config (available to every agent using it).

Functions

Tools agents can call. 7 tools.

Tool	What it does
create_function	Create a tool function that agents can call during conversations.
list_functions	List all tool functions.
search_functions	Search functions by a field value.
get_function	Get full details of a function by ID.
update_function	Update a function — only the fields you pass are changed.
delete_function	Delete a tool function.
associate_integration_with_function	Link an integration to a function so the function can access the integration's secrets.

Chat

Chat sessions, transcripts and handoffs. 13 tools.

Tool	What it does
start_chat_session	Start a new chat session with a team of agents, and run the first message.
get_chat_session_state	Get the current runtime state of a chat session.
get_chat_conversations	Retrieve the conversation messages for a chat session.
search_chat_conversations	Search through a chat session's messages by text content.
list_chat_sessions	List the current user's chat sessions.
get_full_chat_history	Get the complete chat history for the current user across all sessions.
get_active_chat_sessions	List all currently active (in-progress) chat sessions for the user.
end_chat_session	End (close) a chat session.
delete_chat_session	Permanently delete a chat session and its messages.
delete_all_chat_history	Permanently delete all of the current user's chat sessions and messages.
justify_chat_session	Record a business justification for a chat session (governance/compliance).
handoff_chat_session	Hand off a chat session to a different agent or team.
get_chat_runtime_metrics	Get runtime metrics for the chat subsystem (active sessions, throughput, etc.).

Missions

Missions, mission steps, mission configurations and node approvals. 22 tools.

Tool	What it does
create_mission	Create a new mission — a goal-oriented task for agent teams.
list_missions	List all missions for the current user.
get_mission	Get full details of a mission by ID.
update_mission	Update a mission — only the fields you pass are changed.
delete_mission	Delete a mission.
add_child_missions	Link child missions to a parent mission.
remove_child_mission	Unlink a child mission from its parent.
create_mission_step	Add a step to a mission's plan.
list_mission_steps	List all steps for a mission.
get_mission_step	Get a single mission step.
update_mission_step	Update a mission step — only the fields you pass are changed.
delete_mission_step	Delete a mission step.
create_mission_configuration	Create a mission configuration — a reusable preset for mission creation.
list_mission_configurations	List all mission configurations.
get_mission_configuration	Get a mission configuration by ID.
update_mission_configuration	Update a mission configuration — only the fields you pass are changed.
delete_mission_configuration	Delete a mission configuration.
get_mission_schema	Get the JSON schema describing the mission data model.
list_pending_node_approvals	List mission node approvals awaiting a decision across the account.
get_node_approval	Retrieve a single mission node approval.
create_node_approval	Request a human approval for a mission workflow node.
resolve_node_approval	Approve or reject a mission node approval.

Workflows

Workflow definitions, execution, schedules, metrics, test scenarios and run-state. 34 tools.

Tool	What it does
create_workflow	Create a new workflow definition.
list_workflows	List workflow metadata (not full graph data).
get_workflow	Get full workflow definition including nodes and edges.
update_workflow	Update a workflow definition — only the fields you pass are changed.
delete_workflow	Delete a workflow definition.
validate_workflow_definition	Validate a workflow definition without saving it.
get_workflow_schema	Get the JSON schema describing the workflow data model.
visualize_workflow	Get a visualization-friendly representation of a workflow.
get_workflow_framework_graph	Get the framework-level execution graph for a workflow.
instantiate_workflow	Create a new mission instance from a workflow definition.
execute_workflow	Execute a workflow against a mission.
validate_workflow_execution	Check if a workflow is ready for execution.
create_workflow_schedule	Create a schedule to automatically run a workflow.
list_workflow_schedules	List workflow schedules, optionally filtered by workflow.
get_workflow_schedule	Get a workflow schedule by ID.
update_workflow_schedule	Update a workflow schedule — only the fields you pass are changed.
delete_workflow_schedule	Delete a workflow schedule.
get_all_workflow_metrics	Get execution metrics for all workflows (runs, success rate, cost, tokens).
get_workflow_metrics	Get execution metrics for a specific workflow.
run_workflow_node	Run a single node of a workflow in isolation (for debugging/testing).
approve_mission_workflow	Provide an approval response to a paused workflow-driven mission.
resolve_workflow_node_approval	Resolve a node-level approval on a running workflow mission.
create_workflow_test_node	Create a test scenario for a workflow node.
list_workflow_test_nodes	List the test scenarios defined for a workflow.
get_workflow_test_node	Retrieve a single workflow test scenario.
update_workflow_test_node	Update a workflow test scenario — only the fields you pass are changed.
delete_workflow_test_node	Delete a workflow test scenario.
run_all_workflow_tests	Run all defined test scenarios for a workflow.
list_workflow_eval_results	List evaluation results recorded for a workflow's test runs.
get_workflow_run_state	Get all persisted run-state keys for a workflow.
get_workflow_run_state_key	Get a single run-state value by key.
set_workflow_run_state	Set a run-state value for a workflow.
delete_workflow_run_state_key	Delete a single run-state key for a workflow.
clear_workflow_run_state	Delete all run-state for a workflow.

Integrations

Integrations, their secrets and who can use them. 21 tools.

Tool	What it does
create_integration	Create an integration — a connection to an external service.
list_integrations	List all integrations.
search_integrations	Search integrations by field values.
get_integration	Get full details of an integration, including its secret metadata.
update_integration	Update an integration — only the fields you pass are changed.
delete_integration	Delete an integration and all its secrets.
get_integration_schema	Get the JSON schema for the integration data model.
grant_integration_access	Grant a user access to an integration's secrets.
revoke_integration_access	Revoke a user's access to an integration.
list_integration_access	List the subjects (users) that have access to an integration.
list_subject_access	List the integrations a given subject (user) has been granted access to.
list_shared_integrations	List integrations that have been shared with the current user.
add_integration_secret	Add a secret to an integration.
list_integration_secrets	List the secrets an integration holds: names and paths only, never values.
list_integration_secrets_metadata	List secret metadata (names and paths, no values) for an integration.
get_integration_secret	Get a specific secret by ID.
get_integration_secret_by_path	Look up a secret by its logical path.
delete_integration_secret	Delete a secret from an integration.
write_vault_secret	Write a secret directly to the vault.
read_vault_secret	Read a secret from the vault by path.
delete_vault_secret	Delete a secret from the vault by path.

Webhooks

Inbound webhooks that trigger workflows. 7 tools.

Tool	What it does
create_webhook	Create an inbound webhook that can trigger workflow executions.
list_webhooks	List all webhooks.
get_webhook	Get a webhook by ID, including its token and URL.
update_webhook	Update a webhook — only the fields you pass are changed.
delete_webhook	Delete a webhook.
regenerate_webhook_secret	Regenerate the signing secret for a webhook.
get_webhook_logs	Retrieve delivery logs for a webhook.

Event sources

Inbound event channels. 5 tools.

Tool	What it does
create_event_source	Create an event source — an inbound channel that emits events into the platform.
list_event_sources	List event sources.
get_event_source	Retrieve an event source by ID.
update_event_source	Update an event source — only the fields you pass are changed.
delete_event_source	Delete an event source.

Catalog

Manifests and elements. 15 tools.

Tool	What it does
create_manifest	Create a catalog manifest — a typed, structured data record.
list_manifests	List all manifests.
get_manifest_by_name	Retrieve a manifest by its unique name (instead of numeric ID).
search_manifests	Search manifests by text and/or type.
get_manifest	Get a manifest by ID.
update_manifest	Update a manifest — only the fields you pass are changed.
delete_manifest	Delete a manifest.
get_manifest_schema	Get the JSON schema for the manifest data model.
create_element	Create a catalog element — a reusable UI or data component.
list_elements	List all elements.
search_elements	Search elements by field values.
get_element	Get an element by its numeric ID.
update_element	Update an element — only the fields you pass are changed.
delete_element	Delete an element.
get_element_schema	Get the JSON schema for the element data model.

Data sources

Live data feeds and data source templates. 12 tools.

Tool	What it does
create_data_source	Create a data source — a reusable connection to an external or computed data feed.
list_data_sources	List data sources available to the current user.
list_data_source_connectors	List the available data source connector types and their config schemas.
get_data_source	Retrieve a single data source by ID.
update_data_source	Update a data source — only the fields you pass are changed.
delete_data_source	Delete a data source.
get_data_source_data	Fetch the current data for a data source (from cache or freshly fetched).
ingest_data_source_payload	Push a payload into a streaming/push data source.
refresh_data_source	Trigger an immediate refresh of a data source's cached data.
test_data_source	Test a data source connector and preview the data it returns.
list_data_source_templates	List pre-built data source templates available to instantiate.
instantiate_data_source_template	Create a new data source from a data source template.

Knowledge

Knowledge bases, document ingestion and semantic search. 16 tools.

Tool	What it does
create_knowledge_base	Create a knowledge base for retrieval-augmented generation (RAG).
list_knowledge_bases	List knowledge bases available to the current user.
get_knowledge_base	Retrieve a knowledge base by ID.
update_knowledge_base	Update a knowledge base — only the fields you pass are changed.
delete_knowledge_base	Delete a knowledge base and its documents.
get_knowledge_base_readiness	Report whether a knowledge base can be searched by meaning, and why not.
reembed_knowledge_base	Embed the chunks of a knowledge base that have no embedding yet.
list_knowledge_documents	List documents in a knowledge base.
ingest_text_document	Ingest a raw text document into a knowledge base.
ingest_url_document	Fetch a URL and ingest its content into a knowledge base.
ingest_git_document	Ingest files from a git repository into a knowledge base.
ingest_confluence_document	Ingest a Confluence space into a knowledge base.
ingest_manifest_document	Ingest a catalog manifest's records into a knowledge base.
get_ingest_job	Check the status of a knowledge document ingestion job.
search_knowledge_documents	Semantic search over a knowledge base's documents.
delete_knowledge_document	Delete a document from a knowledge base.

Memories

Agent memory. 8 tools.

Tool	What it does
observe_memory	Record an observation in an agent's memory, as the calling user.
search_memories	Search an agent's memories by meaning and keywords, as the calling user.
list_memories	List an agent's stored episodic memories.
consolidate_memories	Consolidate one agent's memory now, under that agent's own memory settings.
summarise_session_to_memory	Extract the facts worth keeping from a chat session into episodic memory.
update_memory	Edit the content of a stored memory.
delete_memory	Delete a single episodic memory.
clear_memories	Delete all of an agent's memories (optionally only a single tier).

Dashboards

Dashboards and their elements. 9 tools.

Tool	What it does
create_dashboard	Create a dashboard.
list_dashboards	List the current user's dashboards.
get_dashboard	Retrieve a dashboard and its elements by ID.
update_dashboard	Update a dashboard — only the fields you pass are changed.
delete_dashboard	Delete a dashboard and its elements.
add_dashboard_element	Add an element (widget) to a dashboard.
update_dashboard_element	Update a dashboard element — only the fields you pass are changed.
delete_dashboard_element	Remove an element from a dashboard.
set_dashboard_layout	Replace a dashboard's grid layout in one call.

Programs

Programs, phases, activities, checkpoints, documents and the program assistant. 31 tools.

Tool	What it does
create_program	Create a program — a multi-phase initiative made of phases and activities.
list_programs	List the current user's programs.
get_program	Retrieve a program by ID, including its phases.
update_program	Update a program — only the fields you pass are changed.
delete_program	Delete a program and its phases/activities.
get_program_events	Get the activity/event log for a program.
list_program_phases	List a program's phases.
add_program_phase	Add a phase to a program.
update_program_phase	Update a program phase — only the fields you pass are changed.
delete_program_phase	Delete a phase from a program.
run_program_phase	Execute a program phase (run its activities).
advance_program_phase	Advance a program to the phase following the given one.
list_phase_activities	List the activities in a phase.
add_phase_activity	Add an activity to a phase.
update_phase_activity	Update a phase activity — only the fields you pass are changed.
delete_phase_activity	Delete an activity from a phase.
run_phase_activity	Run a single activity within a phase.
preview_activity_prompt	Show the exact message an agent or team activity would be sent, including the program context, without running it.
list_activity_runs	List an activity's runs, newest first, with each run's status, summary and artifacts.
create_phase_checkpoint	Create an approval checkpoint on a phase.
resolve_program_checkpoint	Approve or reject a program checkpoint.
list_program_documents	List documents attached to a program.
add_program_document	Attach a document to a program.
update_program_document	Update a program document — only the fields you pass are changed.
delete_program_document	Delete a program document.
list_program_knowledge	List knowledge snippets attached to a program.
add_program_knowledge	Add a knowledge snippet to a program.
program_assistant	Get the agent that builds and runs programs, to start a chat with.
list_program_agent_options	List the agent configs available to drive program activities.
get_program_agent_preference	Get the user's preferred program-assistant agent config.
set_program_agent_preference	Set the user's preferred program-assistant agent config.

Delegation

Hand a task or workflow run to the platform and track it. 7 tools.

Tool	What it does
delegate_task	Delegate a development task to a platform agent (or team) and dispatch it.
run_workflow	Run an existing platform workflow to a terminal state, as a delegation.
delegation_status	Check a delegation's state, progress, summary, artifacts and pull request links, and the question it's waiting on if blocked.
list_delegations	List recent delegations from the standing "Claude Code delegations" program.
answer_delegation	Answer a blocked delegation's question and resume it.
cancel_delegation	Cancel a delegation: end its run, drop any queued work behind it.
create_program_from_plan	Turn an implementation plan into a program with phases, activities, dependencies and approval checkpoints.

Execution environments

Sandboxed runtimes where agent tools run. 9 tools.

Tool	What it does
create_execution_environment	Create an execution environment — a sandboxed runtime for agent tool/code execution.
list_execution_environments	List execution environments available to the current user.
get_execution_environment	Retrieve a single execution environment by ID.
update_execution_environment	Update an execution environment — only the fields you pass are changed.
delete_execution_environment	Delete an execution environment.
get_execution_environment_status	Get the deployment/health status of an execution environment.
list_execution_environment_tools	List the tools available within an execution environment.
generate_execution_environment_token	Generate a connection token a runner uses to register with this environment.
invoke_execution_environment_tool	Invoke a tool inside an execution environment.

Promotions

Promote entities between projects; deploy environments. 7 tools.

Tool	What it does
analyze_promotion	Analyse what promoting an entity to another project would change.
execute_promotion	Execute a promotion using a manifest produced by analyze_promotion.
get_promotion_history	List past promotions.
rollback_promotion	Roll back a previously executed promotion.
deploy_environment	Deploy an environment's configured agents/teams.
get_environment_deploy_status	Get the deploy status of an environment.
teardown_environment	Tear down (undeploy) an environment.

Testing

Test cases for agents and teams. 11 tools.

Tool	What it does
create_agent_test_case	Create an evaluation test case for an agent.
list_agent_test_cases	List an agent's test cases.
create_team_test_case	Create an evaluation test case for a team.
list_team_test_cases	List a team's test cases.
get_test_case	Retrieve a test case by ID.
update_test_case	Update a test case — only the fields you pass are changed.
delete_test_case	Delete a test case.
run_test_case	Execute a test case and score the result.
get_test_case_runs	List historical runs (and scores) for a test case.
get_testing_metrics	List the metric names a test case can be scored on, such as GEval or ToolCorrectness.
get_testing_coverage	Report which agents and teams have test cases, and what state those cases are in.

Observability

Agent and team summaries, errors, audit logs, usage, risk registry and platform models. 13 tools.

Tool	What it does
get_agent_observability_summary	Get an activity summary (runs, latency, token usage) for an agent.
get_agent_errors	List recent errors for an agent.
get_agent_audit_log	Get the audit log of actions taken by/against an agent.
get_team_observability_summary	Get an activity summary for a team.
get_team_errors	List recent errors for a team.
get_team_audit_log	Get the audit log for a team.
get_usage_summary	Get a usage summary (token/cost/run totals) for the current account.
get_daily_usage	Get usage broken down by day.
get_usage_by_agent	Get usage broken down by agent.
get_usage_by_project	Get usage broken down by project.
get_risk_registry	List risk registry entries (functions/integrations/agents flagged for governance review).
get_risk_registry_summary	Get aggregate counts/rollups for the risk registry.
list_platform_models	List the platform-managed models available for use in LLM configs.

Templates

Browse and instantiate templates. 17 tools.

Tool	What it does
list_agent_templates	List available agent templates.
get_agent_template	Get an agent template by ID.
list_function_templates	List available function templates.
get_function_template	Get a function template by ID.
list_llm_config_templates	List available LLM config templates.
get_llm_config_template	Get an LLM config template by ID.
list_team_templates	List available team templates.
get_team_template	Get a team template by ID.
list_manifest_templates	List available manifest templates.
get_manifest_template	Get a manifest template by ID.
list_workflow_templates	List available workflow templates.
get_workflow_template	Get a workflow template by ID.
list_integration_templates	List available integration templates.
get_integration_template	Get an integration template by ID.
instantiate_agent_template	Instantiate a template from the agent service.
instantiate_catalog_template	Instantiate a template from the catalog service.
instantiate_integration_template	Instantiate an integration template.

Analytics

Activity event ingestion. 1 tools.

Tool	What it does
ingest_analytics_events	Ingest a batch of activity/analytics events.