Skip to main content

MCP Integration

Use Inqvey in your AI tool

Inqvey speaks the Model Context Protocol so you can run real market research from inside Claude, ChatGPT, Cursor, VS Code, Windsurf, Continue, and any other MCP-compatible client. Pick your tool below.

Step 1 — Get your API key

Free tier includes 9 research questions. Generate a key in your account, then paste it into your client's config below.

Get API key

Step 2 — Install in your client

Claude Desktop

Works today

Open claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\\Claude\\claude_desktop_config.json

Paste the config below, replace YOUR_API_KEY_HERE with your key, then restart Claude Desktop.

{
  "mcpServers": {
    "inqvey": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://inqvey.com/api/mcp/v1",
        "--header",
        "Authorization: Bearer ${INQVEY_API_KEY}"
      ],
      "env": {
        "INQVEY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor

Works today

One-click install (Cursor 1.0+) — opens Cursor and adds Inqvey with a placeholder. Paste your API key after install.

Add to Cursor

Or edit ~/.cursor/mcp.json manually:

{
  "mcpServers": {
    "inqvey": {
      "url": "https://inqvey.com/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

VS Code (Copilot Chat agent mode)

Works today

Open the command palette and run MCP: Open User Configuration. Add theinqveyentry below to your mcp.json servers block.

Requires VS Code 1.99+ with GitHub Copilot Chat agent mode enabled.

{
  "servers": {
    "inqvey": {
      "type": "http",
      "url": "https://inqvey.com/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

ChatGPT (Developer Mode)

Works today

In ChatGPT, open Settings → Connectors → Developer ModeAdd custom connector. Use these values:

URLhttps://inqvey.com/api/mcp/v1
Auth typeBearer
TokenYOUR_API_KEY_HERE

For listing in the official ChatGPT App Directory, OAuth is required — we're shipping that next. Developer Mode works today.

Windsurf (Cascade)

Works today

Edit ~/.codeium/windsurf/mcp_config.json (or %USERPROFILE%\\.codeium\\windsurf\\mcp_config.json on Windows). Add:

{
  "mcpServers": {
    "inqvey": {
      "url": "https://inqvey.com/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Continue.dev

Works today

Add to your config.yaml:

experimental:
  modelContextProtocolServers:
    - transport:
        type: streamable-http
        url: https://inqvey.com/api/mcp/v1
        headers:
          Authorization: Bearer YOUR_API_KEY_HERE

Cline (VS Code extension)

Works today

Open the Cline sidebar → MCP Servers tab → Add Remote Server. Use these values:

Server nameinqvey
URLhttps://inqvey.com/api/mcp/v1
Header nameAuthorization
Header valueBearer YOUR_API_KEY_HERE

Claude.ai web (Custom Connector)

Coming soon

The claude.ai Custom Connector picker requires OAuth 2.1 with dynamic client registration. We're shipping it next. In the meantime, use Claude Desktop above — same Claude, full MCP access.

Building your own integration?

Inqvey's MCP endpoint is at https://inqvey.com/api/mcp/v1. Bearer auth, JSON-RPC 2.0 over Streamable HTTP, current MCP spec rev 2025-11-25. Discovery document at /.well-known/mcp.json.

Health check (no auth): /api/mcp/v1/health

Troubleshooting

Tools don't show up in my client
Restart the client after editing the config file. Most clients only read MCP servers at startup. If still missing, check the client's logs (e.g. ~/Library/Logs/Claude for Claude Desktop).
I'm getting 401 Unauthorized
Your API key is wrong, revoked, or has a typo. Generate a fresh key at /app/account/api-keys and replace YOUR_API_KEY_HERE in your config.
I'm getting 403 Forbidden
Your client is sending an Origin header we don't recognize (DNS rebinding protection). Email [email protected] with the client name and we'll add it to the allowlist.
Where do I check my quota?
Ask your assistant: "What's my Inqvey quota?" — it'll call the get_account_status tool. Or visit /app/account.