Virtual MCP servers
A Virtual MCP server exposes the tools you choose to an MCP client, for one user at a time. In the API a server is an MCP configuration, under /api/v1/mcp/configs. See Create a Virtual MCP server and Mint session tokens.
A server exposes its tools in one of two ways, set with tool_exposure. DIRECT, the default, lists every tool you map to the server, for up to 25 connections. META gives the agent five tools to search for, inspect and run the mapped tools, and to connect the user's accounts, with no connection limit. See How an agent uses a META server.
| Method | Endpoint | Path | What it does | SDKs |
|---|---|---|---|---|
| POST | Create a Virtual MCP serverCreate a server that serves the connections and tools you choose. | / | Create a server that serves the connections and tools you choose. | PythonNode.js |
| GET | Get a Virtual MCP serverGet a server's connections, tools and MCP server URL. | / | Get a server's connections, tools and MCP server URL. | Python: REST onlyNode.js |
| GET | List Virtual MCP serversList the servers in your environment, with a search on their name. | / | List the servers in your environment, with a search on their name. | PythonNode.js |
| PUT | Update a Virtual MCP serverChange a server's description, the connections and tools it serves, or how it exposes tools. | / | Change a server's description, the connections and tools it serves, or how it exposes tools. | PythonNode.js |
| DELETE | Delete a Virtual MCP serverDelete a server and the connections and tools it serves. | / | Delete a server and the connections and tools it serves. | PythonNode.js |
| POST | Check a user's connected accounts for a serverCheck a user's accounts for a server, with links for any that aren't active. | / | Check a user's accounts for a server, with links for any that aren't active. | PythonNode.js |
| POST | Mint a session tokenMint a short-lived token that lets a user's MCP client call the server. | / | Mint a short-lived token that lets a user's MCP client call the server. | PythonNode.js |
| POST | Mint a session token for a connectionMint a short-lived token that lets a user's MCP client call one connection's tools. | / | Mint a short-lived token that lets a user's MCP client call one connection's tools. | PythonNode.js |