Skip to main content
Tool Gateway is in beta.
The Tool Gateway API configures Tool Gateway and sends MCP calls through it. Every path starts with /v1/managed-tools.

Base URL

Send requests to the API host for your LangSmith region:
Region
GCP US
GCP EU
GCP APAC
AWS US
Tool Gateway is not available in the Azure US region. Choose your region in the server menu of each endpoint’s playground. Browse the full API reference in the Tool Gateway API section in the sidebar. It has two kinds of endpoints:
  • Management endpoints configure Tool Gateway: /servers adds and lists MCP servers, /servers/{id}/credential manages your credential for a server, /kits manages tool kits, /profiles manages profiles, and /oidc-connection links your identity provider.
  • MCP endpoints list and call tools with standard MCP methods such as tools/list and tools/call: /servers/{id}/mcp exposes one server and /kits/{kit_id}/mcp exposes a tool kit.

Authentication

Send a LangSmith API key in the X-Api-Key header, or a token in the Authorization: Bearer header. Send the workspace ID in the X-Tenant-Id header. X-Tenant-Id selects a workspace; it does not authenticate you. To call tools as an end user, an agent, or a profile, see Act as users and agents. Tool Gateway must be enabled for your organization. Each endpoint lists the workspace permissions it requires.