# PreReason MCP server

Pre-reasoned Bitcoin & macro financial briefings for AI agents. Trend signals, regimes, 17 contexts.

## Links
- Registry page: https://www.getdrio.com/mcp/com-prereason-mcp
- Repository: https://github.com/PreReason/mcp
- Website: https://www.prereason.com

## Install
- Command: `npx -y @prereason/mcp`
- Endpoint: https://api.prereason.com/api/mcp
- Auth: Not captured

## Setup notes
- Remote header: X-API-Key (secret)
- Package: Npm @prereason/mcp v0.1.13
- Environment variable: PREREASON_API_KEY (secret)
- Remote endpoint: https://api.prereason.com/api/mcp
- Header: X-API-Key

## Tools
- list_briefings (List Briefings) - List all available pre-reasoned market briefings with tier requirements. Returns 24 LIVE briefings across Free (6), Basic (8), and Pro (10) tiers. Covers Bitcoin, macro, FX, commodities, and cross-asset financial data categories. No authentication required. Endpoint: https://api.prereason.com/api/mcp
- list_metrics (List Metrics) - List all available individual metrics (30 metrics across bitcoin, macro, and calculated categories). Includes Bitcoin price, hash rate, Fed balance sheet, M2 supply, Treasury 10Y yield, net liquidity, and cross-asset indices (SPY, QQQ, VXX, UUP) used as BTC correlation signals. Optionally filter by category or search term. No authentication required. Endpoint: https://api.prereason.com/api/mcp
- get_health (Health Check) - Check API health status, version, and available endpoints. No authentication required. Endpoint: https://api.prereason.com/api/mcp
- get_context (Get Market Briefing) - Get a pre-reasoned market briefing with trend signals, confidence scores, regime classification, and causal narratives for the requested domain (Bitcoin, macro, cross-asset, FX). Includes crypto, macro financial data, and cross-asset correlations (indices, bonds, volatility as BTC relationship signals). Output is decision-ready — designed to be consumed directly by reasoning agents, not parsed for individual values. Briefings are tier-gated: Free (btc.quick-check, btc.context, macro.snapshot, cross.correlations, btc.pulse, btc.grid-stress), Basic (btc.momentum, macro.liquidity, btc.on-chain, cross.breadth, btc.miner-survival, btc.etf-flows, macro.auctions, cross.delta), Pro (btc.full, btc.factors, cross.regime, fx.liquidity, btc.energy, btc.treasury, macro.rates, cross.industrial-regime, cross.inflation-regime, cross.full). Requires API key authentication via Authorization header. Endpoint: https://api.prereason.com/api/mcp
- get_metric (Get Metric Analysis) - Get a single metric with pre-reasoned signal interpretation, trend analysis (7d/30d/90d), confidence score with factor breakdown, momentum, and percentile ranking. Available metrics: bitcoin-price, bitcoin-market-cap, bitcoin-volume-24h, bitcoin-change-24h, bitcoin-dominance, bitcoin-hash-rate, bitcoin-difficulty, bitcoin-tx-count, bitcoin-tx-volume, bitcoin-active-addresses, fed-balance, m2-supply, treasury-10y, rrp, eur-usd, cny-usd, yield-curve, tga, treasury-3mo, treasury-2y, treasury-5y, treasury-30y, breakeven-5y, breakeven-10y, t5yifr, mortgage-30y, t10y3m-spread, auction-bid-to-cover-10y, auction-bid-to-cover-30y, indirect-bidder-pct, dealer-takedown-pct, next-treasury-auction-days, fed-funds-rate, ecb-deposit-rate, boj-policy-rate, fed-ecb-spread, fed-boj-spread, carry-trade-returns-proxy, carry-trade-velocity-1d, mortgage-treasury-spread, iwm-spy-credit-spread, spy-vxx-correlation-30d, regime-stability-flag, jpy-usd, oil-brent, oil-wti, ovx, real-rate-10y, gld-gdx-ratio, copper-gold-ratio, slv-sil-ratio, gdxj-gdx-ratio, gold-silver-ratio, brent-wti-spread, etf-gld-1h-velocity, etf-cper-1h-velocity, etf-uso-1h-velocity, etf-uup-velocity-1h, crude-oil-stocks, natgas-storage, oil-inventory-zscore, natgas-storage-zscore, ecb-boj-spread, etf-gld-volume, etf-uso-volume, etf-uup-volume, etf-gld-volume-zscore-30d, etf-uso-volume-zscore-30d, etf-uup-volume-zscore-30d, net-liquidity, hash-ribbon, mvrv-proxy, etf-spy, etf-qqq, etf-iwm, etf-vxx, etf-uup, etf-gld, etf-gdx, etf-gdxj, etf-slv, etf-sil, etf-uso, etf-ung, etf-cper, etf-weat, etf-tlt, etf-ibit, etf-fxe, etf-fxy, usdt-market-cap, usdt-dominance, btc-price-200d-ma, btc-price-200d-distance, btc-etf-net-flow, btc-etf-cumulative-flow, btc-etf-aum, btc-etf-ibit-flow, btc-etf-fbtc-flow, btc-etf-gbtc-flow, btc-etf-other-flow, btc-etf-ibit-aum, btc-etf-fbtc-aum, btc-etf-bitb-aum, btc-etf-arkb-aum, btc-etf-btco-aum, btc-etf-ezbc-aum, btc-etf-brrr-aum, btc-etf-hodl-aum, btc-etf-btcw-aum, btc-etf-gbtc-aum, btc-etf-btc-aum, bitcoin-price-1h-change-pct, raw-hashprice-tick, on-chain-velocity-30d, bitcoin-volume-zscore-30d. Requires API key authentication. Returns analyzed context (signal, trend direction, momentum, 90d percentile), not raw values. Use when you need to understand what a metric means for decision-making, not just its number. Endpoint: https://api.prereason.com/api/mcp

## Resources
- prereason://catalog/briefings - Complete catalog of all 18 PreReason market briefings with descriptions, tier requirements, and category organization. Use this to discover available briefings before calling get_context. MIME type: application/json
- prereason://catalog/metrics - Complete catalog of all 30 PreReason financial metrics with names, descriptions, categories, and data sources. Covers Bitcoin on-chain, macro liquidity, and cross-asset indices. Use this to discover available metrics before calling get_metric. MIME type: application/json

## Prompts
- daily_market_briefing - Daily Market Briefing Pre-configured prompt for a comprehensive daily Bitcoin and macro market analysis. Fetches BTC price action, macro liquidity indicators, and cross-asset correlations, then synthesizes them into a decision-ready market view with regime classification, trend signals, and risk assessment. Designed for trading agents and portfolio managers. Arguments: focus
- risk_check - Risk Assessment Quick risk assessment prompt that evaluates current market conditions across Bitcoin volatility, macro regime, and cross-asset correlations. Returns a risk score with supporting evidence. Useful for pre-trade checks and portfolio risk monitoring.
- mining_profitability - Mining Profitability Analysis Analyze Bitcoin mining economics: production cost vs market price, miner stress levels, hash rate trends, difficulty adjustments, and fleet-weighted energy costs. Unique intelligence combining on-chain mining data with electricity cost models. Identifies miner capitulation risk and potential supply-side pressure on BTC price. Arguments: depth
- macro_regime_check - Macro Regime Classification Determine the current macro regime and its implications for Bitcoin. Analyzes Fed balance sheet, M2 money supply, net liquidity, Treasury yields, and DXY to classify the macro environment as risk-on, risk-off, transitional, or crisis. Essential context for any BTC position sizing decision.
- correlation_scanner - Cross-Asset Correlation Scanner Scan current correlations between Bitcoin and macro assets (SPY, QQQ, VIX, DXY, Treasury 10Y). Identifies which relationships are strengthening, weakening, or diverging from historical norms. Critical for portfolio construction, hedging decisions, and understanding BTC as a macro asset.
- weekly_recap - Weekly Market Recap Comprehensive weekly recap across Bitcoin, macro, and cross-asset markets. Summarizes the week's key moves, regime changes, trend shifts, and notable divergences. Designed for end-of-week portfolio review and next-week positioning. Uses 7-day change data from multiple briefings. Arguments: scope

## Metadata
- Owner: com.prereason
- Version: 0.7.2
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Mar 18, 2026
- Source: https://registry.modelcontextprotocol.io