Skip to main content
A tool server is an MCP server that exposes Python tools. Unlike an agent, a tool server has no model, system prompt, or conversation history. Use tool servers to share a set of tools across multiple agents or to make them available to external MCP-compatible applications.

​
Creating a tool server

  1. Select Tool Servers from the left-hand navigation.
  2. Select Create.
  3. Enter a name for your tool server, then select Create. The tool server’s editor page opens.
  4. (Optional) Enter a description for your tool server.
  5. Select Add Python Tools to open the tools editor.
  6. Add tool modules using the same process described in Python tools.
  7. Select Start to begin serving.
You can also start a tool server from the Tool Servers page by hovering over its card and selecting Start.
Once started, the tool server runs on an available localhost port and is ready to accept connections.

​
Deleting a tool server

  1. Select Tool Servers from the left-hand navigation.
  2. Select on the tool server’s card.
  3. Select Delete to remove it.

​
Connecting to a tool server

A running tool server can be connected to agents inside Agent Studio or to external MCP-compatible applications. To view connection details, select Connect on the tool server’s editor page.
You can also select Connect on the tool server’s card from the Tool Servers page.
Connection Info dialog showing the SSE URL and a paste-ready Cursor mcp.json configuration snippet
The Connection Info dialog provides the SSE URL and a paste-ready Cursor mcp.json snippet for configuring your connection.
Connect a tool server to an agent by registering it as an MCP server in the global catalog.
  1. Copy the SSE URL from the Connection Info dialog.
  2. Register the tool server as an MCP server using the SSE URL.
  3. Enable the MCP server for your agent.