Skip to main content

MCP server for OpenClaw Consensus ??9-LLM consensus to fight hallucinations. Built by yanmiayn, 16yo Korean solo dev.

Project description

OpenClaw Consensus MCP

9-LLM consensus inside Claude — a hallucination guardrail you can call as a tool.

Built by yanmiayn — 16yo solo dev from Korea, building 9-LLM consensus to fight hallucinations.

What it does

OpenClaw runs the same prompt across 9 frontier LLMs (Claude, GPT, Gemini, Llama, Mistral, etc.), then returns:

  • a consensus answer (with confidence + which models contributed),
  • a disagreement score (high = your single LLM is probably about to hallucinate), and
  • a cheapest route (pick the smallest model combo that still hits your quality bar).

This MCP server exposes those three capabilities as tools so Claude Desktop / Claude Code can call them mid-conversation.

Why consensus?

A single LLM can confidently make things up. Nine models rarely make up the same thing. When 9 models agree, you can trust the answer; when they fan out, you have a cheap, calibrated hallucination signal — before the user sees the wrong answer.

Install

pip install openclaw-consensus-mcp
# or
uv pip install openclaw-consensus-mcp

You also need a RapidAPI key for the OpenClaw Consensus API: https://rapidapi.com/yanmiayn/api/openclaw-consensus

Set it in your environment:

export RAPIDAPI_KEY="your-rapidapi-key"

Claude Desktop config

Add to ~/.claude/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "openclaw-consensus": {
      "command": "openclaw-consensus",
      "env": {
        "RAPIDAPI_KEY": "your-rapidapi-key"
      }
    }
  }
}

For Claude Code:

claude mcp add openclaw-consensus -- openclaw-consensus

Tools

consensus(prompt, mode="balanced")

Get a 9-LLM consensus answer.

  • prompt (string) — the question.
  • mode (string, default balanced)deep (9 models), balanced (5), or fast (3).

Returns

{
  "answer": "string",
  "confidence": 0.0,
  "models_used": ["claude-opus-4.7", "gpt-5.1", "..."],
  "disagreement": 0.0
}

disagreement_score(prompt)

How much the 9 models disagree on a prompt — a hallucination warning signal.

Returns

{
  "score": 0.0,
  "per_model": { "model-id": "answer summary" }
}

cheapest_route(prompt, target_quality=0.85)

Cheapest model combo that meets a quality threshold (0..1).

Returns

{
  "models": ["..."],
  "estimated_cost_usd": 0.0,
  "estimated_quality": 0.0
}

Local development

git clone https://github.com/yanmiayn/openclaw-consensus-mcp
cd openclaw-consensus-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

Smoke-test the server with the official MCP Inspector:

npx @modelcontextprotocol/inspector openclaw-consensus

Publish

uv build
uv publish      # to PyPI
mcp-publisher publish   # to the official MCP Registry

License

MIT — see LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openclaw_consensus_mcp-0.1.1.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openclaw_consensus_mcp-0.1.1-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

Details for the file openclaw_consensus_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: openclaw_consensus_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for openclaw_consensus_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 119bf8e98a969cfb3e2e57d05f7468f331a0ba0d954eaa0d68efcad4dcf05106
MD5 bb9510ea60816cec4a1faab241f89bf0
BLAKE2b-256 a3059c7b39f9fc4d549aa4c11574b842e36054e0958ef1f5956cbadf0f923249

See more details on using hashes here.

File details

Details for the file openclaw_consensus_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: openclaw_consensus_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 7.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for openclaw_consensus_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3e6fb90cf46b361a236fcd2309a56ccd16e5dc5390289d886bb8bbbc12a1d27c
MD5 f4252351f16651b92a83ba22788bf38c
BLAKE2b-256 2ed9c8fa5bcc8a3220b181c5b0fd006578f9643afa1f7fd702f7861746d2b4c8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page