convergeqa-mcp

ConvergeQA is a multi-model document review system with public verification receipts. Its panels challenge thinking, surface disagreements, and document review evidence, while the responsible individual decides what to accept, reject, or revise.

This package exposes two stdio MCP servers:

• convergeqa-mcp reviews (or convergeqa-mcp-reviews): Critique and Iterate review tools.
• convergeqa-mcp compare (or convergeqa-mcp-compare): Compare due-diligence review tools.

Both servers delegate to the same CLI client contracts used by ConvergeQA agent tooling. Reviews consume paid credits. The servers read a ConvergeQA Developer API key or service-account key from environment variables at runtime, and the tool never stores keys.

Links

• API keys: https://convergeqa.net/developers
• Pricing and credits: https://convergeqa.net/pricing
• Agent overview: https://convergeqa.net/agents
• Trust: https://convergeqa.net/trust
• LLM reference: https://convergeqa.net/llms.txt

Install

From PyPI:

uvx convergeqa-mcp reviews
uvx convergeqa-mcp compare

pipx run convergeqa-mcp reviews
pipx run convergeqa-mcp compare

Or directly from Git:

uvx --from git+https://github.com/convergeqa/convergeqa-mcp.git convergeqa-mcp-reviews
uvx --from git+https://github.com/convergeqa/convergeqa-mcp.git convergeqa-mcp-compare

Claude Code

Set CONVERGEQA_API_KEY or CONVERGEQA_SERVICE_ACCOUNT_KEY before starting your MCP client. The default key names are uppercase environment variables.

claude mcp add convergeqa-reviews --env CONVERGEQA_API_KEY=$CONVERGEQA_API_KEY -- uvx --from git+https://github.com/convergeqa/convergeqa-mcp.git convergeqa-mcp-reviews

Add Compare as a second server:

claude mcp add convergeqa-compare --env CONVERGEQA_API_KEY=$CONVERGEQA_API_KEY -- uvx --from git+https://github.com/convergeqa/convergeqa-mcp.git convergeqa-mcp-compare

Claude Desktop

Example claude_desktop_config.json:

{
  "mcpServers": {
    "convergeqa-reviews": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/convergeqa/convergeqa-mcp.git",
        "convergeqa-mcp-reviews"
      ],
      "env": {
        "CONVERGEQA_API_KEY": "${CONVERGEQA_API_KEY}"
      }
    },
    "convergeqa-compare": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/convergeqa/convergeqa-mcp.git",
        "convergeqa-mcp-compare"
      ],
      "env": {
        "CONVERGEQA_API_KEY": "${CONVERGEQA_API_KEY}"
      }
    }
  }
}

If your MCP client does not expand environment placeholders, set the key in the client environment by the method that client supports.

Other MCP Clients

These are standard stdio JSON-RPC MCP servers, so any MCP-capable client can run them: Codex CLI, OpenCode, Cursor, OpenClaw, Hermes Agent, and others. The pattern is always the same: launch the command, pass the API key in the environment.

Codex CLI (~/.codex/config.toml):

[mcp_servers.convergeqa-reviews]
command = "uvx"
args = ["--from", "git+https://github.com/convergeqa/convergeqa-mcp.git", "convergeqa-mcp-reviews"]
env = { "CONVERGEQA_API_KEY" = "<your key>" }

[mcp_servers.convergeqa-compare]
command = "uvx"
args = ["--from", "git+https://github.com/convergeqa/convergeqa-mcp.git", "convergeqa-mcp-compare"]
env = { "CONVERGEQA_API_KEY" = "<your key>" }

For clients without a uvx runtime, install once with pipx install git+https://github.com/convergeqa/convergeqa-mcp.git and point the client at the installed convergeqa-mcp-reviews and convergeqa-mcp-compare commands. Python 3.10 or newer; no other runtime dependencies.

Credentials

The review servers accept these default environment variable names:

• CONVERGEQA_API_KEY
• CONVERGEQA_SERVICE_ACCOUNT_KEY

Tool arguments may override the environment variable name, but literal credential values are rejected.

Protocol

The current servers speak stdio JSON-RPC and report MCP protocol version 2024-11-05, matching the existing ConvergeQA MCP server behavior.