List MCP tools

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

{
  "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"
}

GET

mcp

tools

List MCP tools

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

{
  "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

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.

Start an authorization session

Documentation Index

Authorizations

Query Parameters

Response