PreReason MCP Server

by prereason Your server? Claim it

answering

PreReason is answering right now. Last checked 11 min ago. 157 installs a week from npm. It exposes 7 tools. Last commit 22 Sep 2026.

Bitcoin and macro market briefings for AI agents: trend signals, regimes, liquidity and ETF flows.

Installs per day peak 126 · avg 14 · +132% w/w

a month agotoday

Uptime history 52 days of history · worst day 14%

52 days agonow

16.5%

Uptime 24h

15 of 91 checks

Tools

read from the server

599 ms

Response time

average over 24h

157

Installs / week

npm and PyPI

What changed 15

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 19 August 2026. No other catalogue keeps this.

21 Sep 3 tool descriptions were rewritten get_context, list_briefings, list_metrics

21 Sep 2 tools changed the parameters they ask for get_context, list_metrics

20 Sep 2 tools appeared check_access, request_access

20 Sep a tool changed the parameters it asks for get_health

25 Aug a tool changed the parameters it asks for get_context

20 Aug 3 tool descriptions were rewritten get_context, get_metric, list_metrics

20 Aug 2 tools changed the parameters they ask for get_context, get_metric

19 Aug a tool description was rewritten list_metrics

PreReason does not always answer

Over the last week it answered 18.3% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 11 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp --transport http https://api.prereason.com/api/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://api.prereason.com/api/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://api.prereason.com/api/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://api.prereason.com/api/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://api.prereason.com/api/mcp"
    }
  }
}

This one needs environment variables set before it will start: PREREASON_API_KEY (PreReason API key (starts with pr_live_). Optional: without it the bridge asks for access from inside the session and prints one link for you to approve; the key is then saved under ~/.prereason. Or sign up at prereason.com.), PREREASON_CLIENT (The app this bridge runs in (claude-desktop, cursor, windsurf, claude-code, ...), so your PreReason dashboard names the connection.). The author declared them in the registry entry; get the values from the project itself.

Available tools 7

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

access

check_access

Poll something this session is waiting on. Two shapes, one tool, because both answer the same question: can this session reach the data yet. With claim_code and claim_token, polls a claim started with request_access and returns pending, approved (with the api_key, shown once), delivered, denied or expired. With access_code, polls an access request that a refusal handed back, and returns satisfied once the account reaches what was refused. Call it every poll_interval seconds after the human has opened the link.

briefings

list_briefings

List all available pre-reasoned market briefings with tier requirements. Returns 18 LIVE briefings across Free (6), Basic (6), and Pro (6) tiers. Covers Bitcoin, macro, FX, and cross-asset financial data categories. No authentication required.

context

get_context

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 (equity indices, volatility, the dollar and Treasury yields 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), Pro (btc.full, btc.factors, cross.regime, fx.liquidity, btc.energy, btc.treasury). Requires API key authentication via Authorization header.

health

get_health

Check API health status, version, and available endpoints. No authentication required.

metric

get_metric

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, btc-perp-oi-contracts, btc-perp-positioning-regime, btc-perp-funding-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.

metrics

list_metrics

List all available individual metrics (119 metrics across bitcoin, calculated, macro 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.

request

request_access

Start getting a free PreReason API key from inside this session. Returns a claim_code, a one time claim_token and an approve_url for the human who owns this agent. The human signs in and clicks Approve; then call check_access. No key is issued without that approval, and the key belongs to the human's account. If this session already carries a key, says so and does nothing.

Endpoints

URL	Transport	State	Latency	Checked
https://api.prereason.com/api/mcp	streamable-http	answering	623 ms	11 min ago

Alternatives to PreReason

same job, measured the same way

BPE (Bitcoin Pricing Engine)

by bxetech

Consolidated Bitcoin market data for AI agents: BBO pricing, ML signals, funding skew, briefings.

31 installs/wk local only

Kresmion

by kresmion

Prediction markets, on-chain flows, ETF flows, equities and macro intelligence for AI agents.

answering

PredMCP

by raviolelabs

Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier.

52 tools answering

Jawz

by jawz

Live macro data for AI agents: regime, conditions, liquidity, with input provenance. No signup.

22 tools answering

Newsgurus Intel

by collectorguru

Pay-per-call trading intelligence for AI agents: live market regime, trading signals, composite conv

38 tools answering

Drone Intelligence

by droneintelligence

Drone-sector market intelligence for AI agents: free briefings and profiles, licenced tracker data.

12 tools answering

Fluenta

by fluenta-team

Score business ideas on six live market signals. Launch Readiness Score (LRS) for AI agents.

answering

Mantis

by alfred768

Cross-venue prediction market routing for AI agents with arbitrage, quotes, history, and signals.

6 tools answering

PreReason — questions

Answers built from our own checks of this server.

What can PreReason do?

It exposes 7 tools, read directly from the server on our last check. Among them: check_access, get_context, get_health, get_metric, list_briefings, list_metrics and 1 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is PreReason working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 15 of 91 checks got a reply (16.5%), average response time 599 ms. The bar chart above shows every period we have measured.

How do I connect PreReason?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does PreReason need an API key?

No. PreReason completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 7 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is PreReason?

It answers our handshake in 599 ms on average, which is faster than 23% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use PreReason?

The npm package @prereason/mcp was installed 157 times in the last week. Week over week that is +132%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is PreReason open source?

Yes — it is published under the MIT licence, written in JavaScript and 5 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.