/api/v3/mcp/tools/{name}

Invokes one MCP tool available to the authenticated agent. The
mcp:read scope is always required. Mutating tools additionally require
mcp:write; a token without it receives 403. Tool-level resolution failures
are returned as a successful tool response with isError: true. Arguments
must satisfy the selected tool's inputSchema; undeclared fields are rejected.

Team-scoped tools take a team_id argument naming which of the account's Sunburst
teams the call acts on. It may be omitted when the account has exactly one; with more
than one it is required, and omitting it returns isError: true listing the choices
rather than acting on a guessed team. get_session_context lists them.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Exact tool name returned by GET /api/v3/mcp/tools.

Body Params
arguments
object

Tool arguments. Omit to use the empty-object default.

Responses

400

Missing/malformed JSON, non-object values, or arguments that violate the tool input schema.

401

Missing, invalid, expired, inactive, or non-Bearer credentials.

403

Missing mcp:read, a mutating tool called without mcp:write, or no team on this account is entitled to this surface.

404

Unknown tool, wrong-audience tool, or tool hidden by current access.

500

Unexpected tool infrastructure failure with internal details redacted.

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json