Prereason

What is Prereason?

Prereason is an MCP server for PreReason, the Context API for financial agents. It provides 17 pre-reasoned market briefings covering BTC, macro, cross-asset regimes, and liquidity, each with trend signals, confidence scores, and causal narratives. It is designed for AI agents that need market context rather than raw price feeds.

How to use Prereason?

Connect via one-click OAuth (Claude.ai, ChatGPT, Cursor, Codex, Windsurf, VS Code Copilot) by adding the server URL https://api.prereason.com/api/mcp. Alternatively, use direct HTTP with an API key (for Claude Code, scripts) or a stdio bridge for Claude Desktop (requires Node.js 18+). Get a free API key at prereason.com/signup.

Key features of Prereason

• 5 MCP tools: list_briefings, list_metrics, get_health, get_context, get_metric
• 17 pre-reasoned market briefings (6 free, 5 Basic, 6 Pro)
• 30 available metrics across bitcoin, macro, and calculated categories
• OAuth support for one-click client connection
• HTTP and stdio transport options
• Trend signals, confidence scores, and causal narratives per briefing

Use cases of Prereason

• Ask "What's the current BTC regime?" and get a pre-reasoned briefing
• Request a macro snapshot with Fed balance, M2, treasury yields, VIX
• Fetch a full context briefing for complete market intelligence
• Get a single metric (e.g., bitcoin price) with trend analysis and percentile
• List all available briefings to discover what’s accessible with your tier

FAQ from Prereason

What tools does Prereason provide?

Five tools: list_briefings (list all 17 briefings with tier requirements), list_metrics (list 30 metrics), get_health (API health check), get_context (fetch a briefing as markdown or JSON), and get_metric (fetch a single metric with trend/signal/percentile).

Do I need an API key to use Prereason?

list_briefings, list_metrics, and get_health work without a key. get_context and get_metric require a valid API key (starts with pr_live_). Get a free key at prereason.com/signup.

What are the pricing tiers?

Free tier includes 6 briefings (e.g., btc.quick-check, macro.snapshot). Basic tier ($19.99/mo) adds 5 briefings (e.g., btc.momentum, macro.liquidity). Pro tier ($49.99/mo) adds 6 briefings (e.g., btc.full, cross.regime).

How do I connect Prereason to my MCP client?

Three options: 1) OAuth one-click (add server URL https://api.prereason.com/api/mcp), 2) Direct HTTP with API key in headers, 3) stdio bridge using npx -y @prereason/mcp with PREREASON_API_KEY environment variable (requires Node.js 18+).

What transport protocols does Prereason support?

HTTP (for remote clients like Claude Code, Cursor, Windsurf) and stdio (for Claude Desktop and other stdio-only clients). The stdio bridge package is only needed for clients that require stdio transport.