Querytool MCP

Connect external coding agents (Cursor, Claude Code, etc.) to run query fan-outs via streamable-http MCP. Sign in to generate agent tokens; provider keys can be configured on API Key Management or sent per request (BYOK). MCP endpoint: https://querytool.ai/mcp

Client configuration

Querytool MCP — setup for AI coding agents

Purpose: Run query fan-outs via streamable-http MCP (same business rules as the web async UI).

MCP endpoint: https://querytool.ai/mcp
Transport: streamable-http

1. Agent token (required)
   - Sign in at https://querytool.ai/login, open https://querytool.ai/mcp, and create an agent token. Copy the secret immediately; it is shown only once.
   - Header: Authorization: Bearer <your_agent_token_secret>
   - Do not commit the plaintext secret.

2. Provider keys
   - Default: configure organization Gemini/OpenAI keys at https://querytool.ai/api-keys
   - Optional BYOK on MCP requests: X-Gemini-Api-Key, X-OpenAI-Api-Key

3. MCP client configuration
{
  "mcpServers": {
    "querytool": {
      "url": "https://querytool.ai/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer <your_agent_token_secret>"
      }
    }
  }
}

4. Verify
   - Reload MCP in the client after changing config.
   - Call fanout_list_recent (e.g. limit 5) to confirm authentication.
   - Full pipeline: fanout_submit → poll fanout_status → fanout_results; fanout_cancel to abort.

Tools: fanout_submit, fanout_status, fanout_results, fanout_cancel, fanout_list_recent

Add the querytool server to your MCP client config using the snippet below. Replace <your_agent_token_secret> with a bearer secret from your account (sign in to create one). Optional BYOK headers: X-Gemini-Api-Key, X-OpenAI-Api-Key. Do not commit your plaintext token.

{
  "mcpServers": {
    "querytool": {
      "url": "https://querytool.ai/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer <your_agent_token_secret>"
      }
    }
  }
}

How to test

Sign in and create an agent token on this page.
Configure provider keys on API Key Management or use BYOK headers.
Restart your client or reload MCP servers, then ask the agent to call fanout_list_recent.

HTTP smoke checks (replace YOUR_TOKEN):

# Expect 401 without bearer
curl -s -o /dev/null -w '%{http_code}\n' -X POST 'https://querytool.ai/mcp' \
  -H 'Content-Type: application/json' -d '{}'

# Expect non-401 when bearer is valid (MCP body may still error)
curl -s -o /dev/null -w '%{http_code}\n' -X POST 'https://querytool.ai/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Origin: http://localhost:5173' -d '{}'