Get MCP tools

List the tools offered by the MCP servers configured on an agent.

GEThttps://api.tried.com.au/get-mcp-tools/{agent_id}

Connects to each MCP server in the mcps of the agent's LLM or flow (latest agent version) and returns its tool list. Use it to pick mcp_tool_name values for mcp tools and nodes. Each server is called over Streamable HTTP (initialize, notifications/initialized, then tools/list, up to 10 pages) through the API's SSRF guard.

Request#

Path parameters#

Parameter	Type	Required	Description
`agent_id`	string	Yes	The agent.

Query parameters#

Parameter	Type	Required	Description
`mcp_id`	string	No	Only this server.

Example request#

curl "https://api.tried.com.au/get-mcp-tools/agent_3f9a1c0b2d4e5f6a7b8c9d0e" \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/get-mcp-tools/agent_3f9a1c0b2d4e5f6a7b8c9d0e", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/get-mcp-tools/agent_3f9a1c0b2d4e5f6a7b8c9d0e",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
data = res.json()

Response#

200 OK with one entry per server. A server that fails returns tools: [] and an error instead of failing the request.

[
  {
    "mcp_id": "crm",
    "name": "CRM",
    "tools": [
      { "name": "lookup_customer", "description": "Find a customer by phone number", "input_schema": { "type": "object", "properties": { "phone": { "type": "string" } } } }
    ],
    "error": null
  }
]

Field	Type	Description
`tools[].input_schema`	object	The tool's JSON schema. `{ "type": "object", "properties": {} }` when the server gave none.
`error`	string or null	Why the server could not be listed.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `agents` scope.
`404`	The agent does not exist, or it has no server with this `mcp_id`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.