Tool Gateway is in beta.
Client requirements
The client must support Streamable HTTP and let you set a custom request header. The header carries a LangSmith API key, which decides whose credentials each call uses:- Personal access token: Calls run as you, with the accounts you connected. Use this for your own coding assistant.
- Service key or agent key: Calls run as a user, an agent, or a profile, chosen by extra headers or by the key itself. See Act as users and agents.
X-Tenant-Id header.
Find the kit’s MCP URL
A kit’s MCP URL has the form<langsmith-api-url>/v1/managed-tools/kits/<kit-id>/mcp. For example, on US LangSmith Cloud: https://api.smith.langchain.com/v1/managed-tools/kits/<kit-id>/mcp.
To copy it, go to Tools > Tool kits and open the kit. The kit’s panel shows:
- The MCP URL, with your region’s API URL filled in.
- Setup for Claude Code, Managed Deep Agents, and Cursor, with the kit’s URL already in each snippet.
- A Search mode switch that changes the URL and every snippet to search mode.
/v1/managed-tools/kits/me/mcp, and it replaces the kit URL in any of the following steps.
Add the kit to a client
Every client needs the same two values: the kit’s MCP URL and a LangSmith API key. Only the place you enter them differs. Choose your client below, or follow the pattern in Other MCP clients.Claude Code
Runclaude mcp add in your project, with the kit’s URL and your API key in the X-Api-Key header. The commands on this page use the environment variables from the quickstart:
claude mcp list and confirm that the server shows as connected. For more on adding MCP servers to Claude Code, see the Claude Code MCP docs.
Claude Code lists every tool in the kit, including tools on servers you have not connected yet. The first time you call one of those tools, Claude Code shows a link to connect the server.
Cursor
Add the kit to yourmcp.json file, and replace <langsmith-api-key> with your API key:
mcp.json, open Settings > MCPs in Cursor and click Reload so that Cursor picks up the kit.
Managed Deep Agents
A Managed Deep Agents project declares the kit as an MCP server with"auth": "langsmith". The agent then sends the deployment’s LangSmith API key and workspace on each call. Tool Gateway uses the credentials of the person running the agent, or of the agent in an agent-owned schedule.
Using Tool Gateway with Managed Deep Agents requires
managed-deepagents version 0.10.5 or later, in both the Python and TypeScript packages.tools/mcp.py or tools/mcp.ts, add the kit to the servers map:
mcp once per project, and add each kit or server as an entry in its servers map. To run the agent locally in Studio, set LANGSMITH_WORKSPACE_ID to your workspace ID and LANGSMITH_API_KEY to a personal access token in your environment.
"auth": "langsmith" cannot be combined with a connection, or with headers that choose whose credentials to use. To use a profile on every run instead, set "auth": {"type": "langsmith", "profile": "<profile-id>"}. For other MCP server options, see MCP connectors.
Other MCP clients
Any client that meets the requirements works the same way: give it the kit’s URL and anX-Api-Key header. For example, with a LangChain agent and langchain-mcp-adapters:
Use search mode for large kits
Many clients put every tool a server lists into the model’s prompt. A kit with many tools can fill the prompt with tool definitions and make tool choice less accurate. In search mode, the kit lists three tools instead, and the model uses them to find and call the tools it needs. To turn on search mode, add?mode=search to the kit’s URL, or turn on Search mode in the kit’s panel:
? as a wildcard:
The model typically calls
search_tools, then get_tool, then call_tool. To skip get_tool, the model can call search_tools with full_results set to true. Clients such as Claude Code use the three tools with no extra setup.
Search mode changes only what the kit lists:
- Servers you have not connected: Their tools still appear in search results, with
connectedset tofalse, and are matched by name only. Calling one asks you to connect, as a direct call does. - Direct calls: Calling a tool by its kit name, such as
linear_list_issues, still works in search mode. - Policies: Policies apply to the tool that
call_toolruns, as they do to a direct call.
See also
- Create tool kits
- Connect accounts
- Act as users and agents
- Call tools
- MCP connectors in Managed Deep Agents
Connect these docs to your agent of choice via MCP for real-time answers.

