mcp

Get Tools

Changed on

Return MCP tools — from cache if fresh, otherwise by fetching from remote.

On cache miss, tries manifest fetch first (fast), then falls back to full MCP handshake. Caches the result before returning.

Pass force_refresh=true to bypass the cache and always fetch from the remote server (the result is still cached via upsert for future requests).

agent_id lets deployment/service-key callers name an agent OAuth subject. ls_user_id overrides are limited to service identities.

get/api/v1/mcp/tools

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v1/mcp/tools
  • Auth
    • API key in header X-API-Key
    • or API key in header X-Tenant-Id
    • or HTTP bearer

Query parameters

urlstring required
oauth_provider_idstring nullable
ls_user_idstring nullable
agent_idstring nullable
force_refreshboolean

Response

Successful Response

toolsobject[] required
cachedboolean required
fetched_atstring date-time nullable required
server_icon_urlstring nullable

Changes

  • 7a01c01f75e8Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 1a8ee9358d81Revision changes
    • breaking

      the / response's property type changed from object to string for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • info

      added the new optional query request parameter agent_id