Guide
MCP setup
Connect the endpoints to Claude, Cursor, or any MCP-compatible client.
The Model Context Protocol lets an AI assistant call external tools. Point a client at our MCP endpoint and every endpoint in the catalogue becomes a tool the model can invoke on its own - with the credit cost included in each tool description so it can choose sensibly between them.
Cursor (hosted HTTP)
Cursor speaks HTTP natively. One URL, authenticated with your API key, nothing to install:
{
"mcpServers": {
"toolbox": {
"url": "https://toolkitbackend-j69m.onrender.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer tb_live_<your_api_key>"
}
}
}
}- Create a key on the API keys page.
- Create
.cursor/mcp.jsonin your project, or edit the global one in Settings → MCP. - Paste the block above, replacing the placeholder with your real key.
- Reload Cursor. The endpoints appear in its tool list.
Claude Desktop (stdio bridge)
Claude Desktop speaks stdio, not HTTP. The bridge is a tiny local process that forwards tool calls to the same API. TOOLBOX_API_URL must be the API host (the value substituted below), not the website - the site does not proxy /api/v1.
{
"mcpServers": {
"toolbox": {
"command": "npx",
"args": ["-y", "toolbox-mcp"],
"env": {
"TOOLBOX_API_KEY": "tb_live_<your_api_key>",
"TOOLBOX_API_URL": "https://toolkitbackend-j69m.onrender.com"
}
}
}
}Verifying it works
Ask the assistant something that needs a tool, such as "what are the MX records for example.com?". It should call dns-lookup and answer from the result. Each call appears in your usage log with the source marked MCP.
When something goes wrong
| Symptom | Cause and fix |
|---|---|
| No tools appear | The key is wrong or revoked. Check it in the dashboard and restart the client - most clients only read config at startup. |
| npx toolbox-mcp fails | The package is not on npm yet. Run node mcp-bridge/bin/toolbox-mcp.js from this repo instead, or publish the package. |
| Tools appear but every call fails | Usually an empty balance. The error text says insufficient_credits; top up and retry. |
| Client will not start | Almost always malformed JSON in the config file. Paste it into a JSON validator - a trailing comma is the usual culprit. |