io.github.Advanced-Binary-Operations/quredec

Official

by Advanced-Binary-Operations · Python

QuReDec

Evidence-backed decision briefs with citations — recommendation, confidence, risks, sources.

Generate evidence-backed decision briefs with recommendations, confidence scores, and sources.

README.md3 KBView on GitHub

QuReDec MCP Server

Run a structured QuReDec decision brief from inside Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.

Status: alpha (2026-04-30). Wired to the live QuReDec public API (/api/v1/brief*, per-user Bearer-token auth). Set QUREDEC_MOCK=1 for offline development.

What this does

Tool	Description
`decision_brief`	Submit a question; receive a structured, evidence-backed decision brief with citations
`get_brief_status`	Poll an in-progress brief by ID
`list_recent_briefs`	List the caller's recent briefs

The completed brief contains: executive_summary, recommendation, confidence (0–1), key_facts[].citation_ids, implications[], actions[] (with effort + impact), risks[] (with severity + citation_ids), and citations[] (with citation_id, title, url, source_type).

Install

bash

pip install quredec-mcp

Or from source:

bash

git clone https://github.com/Advanced-Binary-Operations/QuReDec_MCP
cd QuReDec_MCP
pip install -e .

Configure

Generate a QuReDec API key at https://quredec.com/account → API keys. Each key is shown to you exactly once at creation; copy it into a password manager immediately.

Add to your MCP client config (Claude Desktop example):

json

{
  "mcpServers": {
    "quredec": {
      "command": "quredec-mcp",
      "env": {
        "QUREDEC_API_KEY": "qrd_live_xxxxxxxxxxxx"
      }
    }
  }
}

Optional env vars:

QUREDEC_BASE_URL — defaults to https://quredec.com.
QUREDEC_MOCK=1 — run against an in-process mock for development.

Usage example

In Claude Code or Claude Desktop:

Use the decision_brief tool to evaluate "Should I migrate from Stripe to LemonSqueezy?"

The brief comes back with: recommendation, confidence score, key facts with inline citation ids, risks, recommended actions, and a public share URL. Briefs typically take 2–5 minutes; the tool blocks and polls by default (timeout 600 s) and falls back to a synthetic running status with a poll hint if the timeout fires.

Pricing

The MCP server is free. Briefs consume credits from your QuReDec account:

Starter $4.99 — 3 briefs (one-time)
Pro $49/mo — 30 briefs/mo

See https://quredec.com/pricing.

Development

Unit tests run against the in-process mock (no network, no key required):

bash

pip install -e ".[dev]"
QUREDEC_MOCK=1 pytest

Run the server locally against the mock:

bash

QUREDEC_MOCK=1 quredec-mcp

Live integration test

scripts/integration_test.py exercises the full path against quredec.com: submit → poll → assert brief schema → list. It consumes 1 credit from the account whose key you pass in, so run it sparingly.

bash

QUREDEC_API_KEY=qrd_live_xxxxxxxxxxxx \
  python scripts/integration_test.py

Optional env vars:

QUREDEC_BASE_URL — defaults to https://quredec.com.
QUREDEC_QUESTION — override the default seed question.
QUREDEC_TIMEOUT — poll timeout in seconds (default 600).

Exit code 0 on full pass, 1 on the first failed assertion.

License

MIT — see LICENSE.

Maintainer

Advanced Binary Operations LLC · support@advancedbinaryoperations.com

Install

Configuration

Environment variables

QUREDEC_API_KEYrequiredsecret

Per-user API key. Generate one at https://quredec.com/account.

QUREDEC_BASE_URL

Override the QuReDec API host. Defaults to https://quredec.com.

QUREDEC_MOCK

Set to 1 to run against an in-process mock (no network, no API key required). Development use only.

claude_desktop_config.json

{
  "mcpServers": {
    "quredec": {
      "command": "uvx",
      "args": [
        "quredec-mcp"
      ],
      "env": {
        "QUREDEC_API_KEY": "<YOUR_QUREDEC_API_KEY>",
        "QUREDEC_BASE_URL": "<YOUR_QUREDEC_BASE_URL>",
        "QUREDEC_MOCK": "<YOUR_QUREDEC_MOCK>"
      }
    }
  }
}