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.

​
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.