List MCP tools

Return tools exposed by a registered MCP server. The API serves cached results when fresh; otherwise, it fetches tools from the remote MCP server and caches the response.

GET /mcp/tools

List MCP tools

cURL

curl --request GET \
  --url https://api.smith.langchain.com/v1/deepagents/mcp/tools \
  --header 'X-Api-Key: <api-key>'

200

basic

{ "tools": [ { "name": "read_url_content", "description": "Read and extract content from a URL.", "inputSchema": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [ "url" ] } } ], "cached": true, "fetched_at": "2026-06-01T20:50:32Z" }

Authorizations

X-Api-Key · string · header · default: LANGSMITH_API_KEY · required

Query Parameters

url · string<uri> · required

Registered MCP server URL to fetch tools from.

oauth_provider_id · string

OAuth provider ID for token-based MCP server auth.

force_refresh · boolean · default: false

Skip cached tool definitions and fetch fresh tools from the MCP server.

ls_user_id · string

User ID override for service-key callers.

Response

200

application/json

MCP tools returned.

tools · object[]

Tools exposed by the MCP server.

Show child attributes

cached · boolean

Whether the response came from the MCP tools cache.

fetched_at · string

UTC timestamp when the tools were fetched from the MCP server.