Parallect MCP Server

A Model Context Protocol server for Parallect.ai — multi-provider deep research from AI.

This MCP server gives AI assistants (Cursor, Claude Desktop, Claude Code, etc.) access to Parallect's deep research capabilities: submit queries, track progress, retrieve synthesized reports with cross-referenced citations, and explore claims with full evidence chains.

Quick Start

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "parallect": {
      "command": "npx",
      "args": ["-y", "@parallect/mcp-server"],
      "env": {
        "PARALLECT_API_KEY": "par_live_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "parallect": {
      "command": "npx",
      "args": ["-y", "@parallect/mcp-server"],
      "env": {
        "PARALLECT_API_KEY": "par_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add parallect -- npx -y @parallect/mcp-server

Then set PARALLECT_API_KEY in your environment.

Transport Modes

The server supports two transport modes: stdio for local MCP clients and HTTP for hosted/remote deployments.

Stdio (Local)

Used by Cursor, Claude Desktop, Claude Code, and other local MCP clients. The API key is set via environment variable and used for all requests.

Hosted HTTP

Runs as a standalone HTTP server. Each client authenticates with their own Authorization: Bearer <token> header, which is passed through to the Parallect API.

# Start the HTTP server
PORT=8080 PARALLECT_API_URL=https://parallect.ai npm run start:http

Clients send MCP JSON-RPC messages via POST /mcp with their API key as a Bearer token:

curl -X POST http://localhost:8080/mcp \
  -H "Authorization: Bearer par_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{...},"id":1}'

Variable	Required	Default	Description
PORT	No	8080	HTTP server listen port
PARALLECT_API_URL	No	https://parallect.ai	API base URL

No PARALLECT_API_KEY env var is needed in HTTP mode — each request carries its own token.

Configuration (stdio mode)

Variable	Required	Default	Description
PARALLECT_API_KEY	Yes	—	Your Parallect API key (par_live_...)
PARALLECT_API_URL	No	https://parallect.ai	API base URL (for self-hosted or dev)

Get your API key at parallect.ai/settings.

Available Tools

Tool	Description
research	Submit a deep research query across multiple AI providers
research_status	Check progress of a running research job
get_results	Retrieve the synthesized report, citations, and claims
follow_up	Pursue follow-on research in the same thread
list_threads	List your recent research threads
get_thread	Get a thread with all messages, jobs, and results
balance	Check your credit balance and recent transactions
usage	View spend analytics by provider and time period
list_providers	See available research providers and budget tiers
search_claims	Search and filter extracted claims
get_claim_evidence	Get the full evidence chain for a specific claim

Development

npm install
npm run build

# stdio mode
npm start

# HTTP mode
npm run start:http

Or for development with auto-reload:

# stdio
npm run dev

# HTTP
npm run dev:http

License

MIT