@prereason/mcp
MCP server for PreReason - the Context API for financial agents.
Give your agent market context, not raw price feeds. 17 briefings covering BTC, macro,
cross-asset regimes, and liquidity - each with trend signals, confidence scores, and causal narratives.
Quick Start
Option 1: One-Click Connect (Claude.ai, ChatGPT, Cursor, Codex, Windsurf, VS Code Copilot)
Clients that support MCP OAuth can connect with no API key setup required. Add the server URL and the client handles the rest - you'll be prompted to sign in or create a free account, and your API key is provisioned automatically.
{
"mcpServers": {
"prereason": {
"type": "http",
"url": "https://api.prereason.com/api/mcp"
}
}
}
No Authorization header needed - OAuth handles it.
Option 2: Direct HTTP with API Key (Claude Code, scripts, cron jobs)
For CLI tools or when you want to use an existing API key:
# Claude Code (CLI one-liner)
claude mcp add prereason --transport http https://api.prereason.com/api/mcp
Or with an explicit key in your MCP config:
{
"mcpServers": {
"prereason": {
"type": "http",
"url": "https://api.prereason.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Option 3: stdio bridge (Claude Desktop and other stdio-only clients)
Requires Node.js 18+
Add to your MCP client config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"prereason": {
"command": "npx",
"args": ["-y", "@prereason/mcp"],
"env": {
"PREREASON_API_KEY": "YOUR_API_KEY"
}
}
}
}
Claude Desktop config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Restart your MCP client after editing the config. PreReason should appear with 5 tools.
Get an API Key
- Sign up at prereason.com/signup
- Go to Dashboard > Settings > API Keys
- Copy your key (starts with
pr_live_)
5 MCP Tools
| Tool | Auth | Description |
|---|---|---|
list_briefings |
Open | List all 17 pre-reasoned market briefings with tier requirements |
list_metrics |
Open | List all 30 available metrics across bitcoin, macro, and calculated categories |
get_health |
Open | API health check, version, account tier |
get_context |
Required | Fetch a pre-reasoned market briefing (markdown or JSON) |
get_metric |
Required | Fetch a single metric with trend/signal/percentile |
17 Market Briefings
Free (6 briefings)
| Briefing | Description |
|---|---|
btc.quick-check |
Minimal fast context: BTC + Net Liquidity + correlation |
btc.context |
BTC + liquidity + hash ribbon + difficulty + momentum |
macro.snapshot |
Fed balance, M2, treasury yields, VIX, net liquidity |
cross.correlations |
BTC correlation matrix vs macro indicators |
btc.pulse |
Volume, fees, mempool analysis |
btc.grid-stress |
Epoch pace and difficulty adjustment forecast |
Basic - $19.99/mo (5 briefings)
| Briefing | Description |
|---|---|
btc.momentum |
200D MA support/resistance with 7d/30d/90d momentum and YTD percentiles |
macro.liquidity |
Liquidity indicators with momentum analysis |
btc.on-chain |
Hash rate, difficulty, fees, mempool health |
cross.breadth |
Cross-asset breadth with SPY, DXY, VIX |
btc.miner-survival |
Hashprice thermometer with miner stress scoring |
Pro - $49.99/mo (6 briefings)
| Briefing | Description |
|---|---|
btc.full |
Complete market intelligence with all metrics and analysis |
btc.factors |
Multi-factor attribution for BTC price movements |
cross.regime |
Regime classification (risk-on/risk-off/transition) with USDT.D risk sentiment |
fx.liquidity |
FX environment with DXY, treasury, and global liquidity |
btc.energy |
Production cost model with gas input pressure |
btc.treasury |
Corporate Bitcoin treasury intelligence from SEC filings |
Example Prompts
Once connected, try prompts like:
- "What's the current BTC regime?"
- "Show me the macro snapshot"
- "What does the full context briefing say about market conditions?"
- "Get the bitcoin price metric with trend analysis"
- "What's the hash ribbon signal right now?"
- "List available briefings"