Connect ToolGrid MCP

Choose your client

Never paste a raw tg_api_… key into ChatGPT chat. Prefer OAuth for any cloud AI client.

1. Prerequisites

1. Sign in at toolgrid.io.
2. Open Dashboard → TOOLGRID API GATEWAY and confirm an active Developer API subscription.
3. Confirm API credits > 0 on Credits (billing docs).
4. For Cursor: create a key at Keys and copy tg_api_… once into a password manager.
5. Open Dashboard → MCP and confirm status is Enabled with resource URL https://api.toolgrid.io/mcp.

2. Cursor — remote MCP (API key)

Connect Cursor on your laptop to production ToolGrid MCP. Use any personal or work project — you do not need the ToolGrid repository.

1. Open Cursor → Settings → MCP (or your user-level MCP JSON).
2. Add a remote HTTP / Streamable HTTP server pointing at production:

{
  "mcpServers": {
    "toolgrid": {
      "url": "https://api.toolgrid.io/mcp",
      "headers": {
        "Authorization": "Bearer tg_api_YOUR_KEY"
      }
    }
  }
}

• Replace tg_api_YOUR_KEY with your key from Dashboard → Keys.
• Exact JSON field names can vary by Cursor version. If the UI offers an HTTP / SSE / Streamable HTTP URL field, paste https://api.toolgrid.io/mcp and set the Bearer header there.
• Reload MCP servers or restart Cursor after saving.
• Do not clone ToolGrid or run a local backend just to connect. If your Cursor build cannot add a remote URL MCP server, use the ChatGPT OAuth path below.

Confirm tools appear

In Agent/chat for that project, ToolGrid should expose:

• toolgrid_search_tools
• toolgrid_get_tool_schema
• toolgrid_preview_price
• toolgrid_execute
• toolgrid_create_job
• toolgrid_get_job
• toolgrid_balance

Try it (example prompts)

1. Use ToolGrid MCP toolgrid_balance and tell me my remaining API credits. — should match Dashboard → Credits.
2. Call toolgrid_search_tools with query "password" and limit 5.
3. Call toolgrid_get_tool_schema for password_generator.
4. Call toolgrid_preview_price for password_generator (useAI false). — no charge.
5. Call toolgrid_execute for password_generator, count 1, length 16. Show the password and billing. — then check Usage and Credits: balance should decrease once.

3. ChatGPT — custom MCP (OAuth)

Use your ChatGPT account on a plan/workspace that allows custom MCP. Authentication is OAuth — no API key in the chat.

1. In ChatGPT, open Apps / Plugins / MCP settings.
2. Add a custom MCP server:
   • Name: ToolGrid
   • Server URL: https://api.toolgrid.io/mcp
   • Authentication: OAuth (not “no auth”, not paste API key)
3. Save. ChatGPT discovers OAuth and may register a client automatically.
4. Browser opens https://www.toolgrid.io/oauth/mcp/consent. Sign in with the same ToolGrid account that has the Developer API subscription.
5. Review client, redirect URI, and scopes — then click Approve.
6. Return to ChatGPT. Tokens are exchanged server-side; raw API keys are never shared.

Conversation checks

Start a new chat, attach/select ToolGrid if required, then:

1. Search: toolgrid_search_tools with query password.
2. Schema + preview for password_generator.
3. Execute once (count 1) and confirm credits charged.
4. Call toolgrid_balance.

On ToolGrid, open Dashboard → MCP — Connected OAuth grants should list the ChatGPT client. After a successful execute, Usage and Credits update. Revoke the grant to block further calls until re-auth.

4. What agents can call

Newly enabled gateway tools appear in search automatically — no separate MCP mapping. Cursor and ChatGPT debit the same API credit wallet.

5. Troubleshooting

6. Security checklist

• Keep tg_api_… in Cursor config / a password manager only — never in ChatGPT prompts, public repos, or gists.
• Prefer OAuth for cloud AI clients.
• After demos: revoke OAuth grants on Dashboard → MCP; rotate test API keys if they left your machine.
• Only use HTTPS production endpoints for customer integrations.

Related docs

• ToolGrid MCP product page
• Gateway quick start
• Authentication
• Billing & API credits
• Tool catalog
• Dashboard → MCP