List Agent MCP Tools

GET

/v1/agents/{agent_id}/mcp-tools

Send

Authorization

Path

Query

Every MCP tool this agent can call, grouped by server.

Mounted under the app's /v1 prefix, so the full path is /v1/agents/{agent_id}/mcp-tools.

Authorized through _get_owned_agent, the same helper the PATCH, DELETE and widget-key routes in this file use: it admits the creator, an org ADMIN/OWNER of an org-owned agent, and global-access admins, and resolves every denied case to 404 so the response does not confirm that another tenant's agent exists. get_owned_by_id is deliberately NOT used here - it compares only against context.user_id, so it would refuse org admins who can already read this agent through GET /agents/{id} and edit its workflow.

Filtered by each bundle entry's own allowed_tools with the same matches_pattern the bundler resolve path uses, so the editor can never offer a tool the deployment would refuse at run time.

Path Parameters

Query Parameters

Response Body

curl -X GET "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/mcp-tools"

{  "servers": [    {      "alias": "string",      "serverName": "string",      "iconUrl": "string",      "tools": [        {          "toolName": "string",          "displayName": "string",          "description": "string",          "inputSchema": {}        }      ]    }  ]}

{  "detail": "string",  "code": "string"}

{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}