PreReason

Official7 toolsLive

by PreReason · JavaScript

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

com.prereason/mcp (Model Context Protocol) Server

This MCP server provides pre-reasoned Bitcoin and macro financial briefings for AI agents. It focuses on trend signals and market regimes, and organizes information into 17 contexts. The package is named com.prereason/mcp and includes 5 tools.

🛠️ Key Features

Pre-reasoned Bitcoin & macro financial briefings
Trend signals
Regimes
17 contexts

🚀 Use Cases

Supplying AI agents with structured Bitcoin and macro financial context
Providing signals and regime context for downstream agent reasoning

⚡ Developer Benefits

Tooling support via 5 MCP tools
Consistent context organization across 17 contexts

⚠️ Limitations

Scope is limited to Bitcoin & macro financial briefings (no other domains are described)
The available documentation excerpt is incomplete, so tool names and exact inputs/outputs are not shown here

Topics

ai-agentsbitcoinmacromarket-datamcpmcp-server

Captured live from the server via tools/list.

list_briefings

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

Parameters1

tier

string

optional

Filter briefings by subscription tier (free, basic, or pro). Returns all tiers if omitted.

Raw schema

{
  "type": "object",
  "properties": {
    "tier": {
      "type": "string",
      "enum": [
        "free",
        "basic",
        "pro"
      ],
      "description": "Filter briefings by subscription tier (free, basic, or pro). Returns all tiers if omitted."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_metrics

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

Parameters2

category	string	optional	Filter by metric category: bitcoin, calculated, eth, macro
search	string	optional	Search term to filter metrics by name or description

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "bitcoin",
        "calculated",
        "eth",
        "macro"
      ],
      "description": "Filter by metric category: bitcoin, calculated, eth, macro"
    },
    "search": {
      "type": "string",
      "maxLength": 100,
      "description": "Search term to filter metrics by name or description"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_health

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

Parameters1

verbose

boolean

optional

Include detailed endpoint descriptions and data coverage info. Defaults to false.

Raw schema

{
  "type": "object",
  "properties": {
    "verbose": {
      "type": "boolean",
      "description": "Include detailed endpoint descriptions and data coverage info. Defaults to false."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

client_name	string	optional	The app or agent asking, for example "Claude Desktop" or "portfolio-bot". Becomes the key name: "Agent: <client_name>".
purpose	string	optional	One line on what the key is for; shown to the human on the approval page.

Raw schema

{
  "type": "object",
  "properties": {
    "client_name": {
      "type": "string",
      "maxLength": 64,
      "description": "The app or agent asking, for example \"Claude Desktop\" or \"portfolio-bot\". Becomes the key name: \"Agent: <client_name>\"."
    },
    "purpose": {
      "type": "string",
      "maxLength": 200,
      "description": "One line on what the key is for; shown to the human on the approval page."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

claim_code	string	optional	The claim_code from request_access, PR-XXXX-XXXX. Pass with claim_token.
claim_token	string	optional	The claim_token from request_access, prc_...
access_code	string	optional	The access_code from the access_request block of a refusal, PR-XXXX-XXXX. Polled with the API key this session already holds.

Raw schema

{
  "type": "object",
  "properties": {
    "claim_code": {
      "type": "string",
      "maxLength": 16,
      "description": "The claim_code from request_access, PR-XXXX-XXXX. Pass with claim_token."
    },
    "claim_token": {
      "type": "string",
      "maxLength": 64,
      "description": "The claim_token from request_access, prc_..."
    },
    "access_code": {
      "type": "string",
      "maxLength": 16,
      "description": "The access_code from the access_request block of a refusal, PR-XXXX-XXXX. Polled with the API key this session already holds."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 (macro.rates, btc.full, btc.factors, cross.regime, fx.liquidity, btc.energy, btc.treasury). Requires API key authentication via Authorization header.

Parameters3

briefing	string	required	Briefing ID to fetch
format	string	optional	Response format: markdown (human-readable, default) or json (structured data)
date	string	optional	Historical date in YYYY-MM-DD format (tier-gated: Free=30d, Basic=from Jan 2025, Pro=all)

Raw schema

{
  "type": "object",
  "properties": {
    "briefing": {
      "type": "string",
      "enum": [
        "btc.quick-check",
        "btc.context",
        "macro.snapshot",
        "cross.correlations",
        "btc.pulse",
        "btc.grid-stress",
        "btc.momentum",
        "macro.liquidity",
        "macro.rates",
        "btc.on-chain",
        "cross.breadth",
        "btc.miner-survival",
        "btc.full",
        "btc.factors",
        "cross.regime",
        "fx.liquidity",
        "btc.energy",
        "btc.treasury",
        "btc.etf-flows"
      ],
      "description": "Briefing ID to fetch"
    },
    "format": {
      "type": "string",
      "enum": [
        "json",
        "markdown"
      ],
      "default": "markdown",
      "description": "Response format: markdown (human-readable, default) or json (structured data)"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Historical date in YYYY-MM-DD format (tier-gated: Free=30d, Basic=from Jan 2025, Pro=all)"
    }
  },
  "required": [
    "briefing"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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, treasury-1mo, treasury-1-5mo, treasury-2mo, treasury-4mo, treasury-6mo, treasury-1y, treasury-3y, treasury-7y, treasury-20y, 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, cot-spx-noncomm-net, cot-spx-noncomm-net-percentile-26w, cot-spx-noncomm-net-percentile-52w, cot-spx-noncomm-net-percentile-156w, cot-gold-noncomm-net, cot-gold-noncomm-net-percentile-26w, cot-gold-noncomm-net-percentile-52w, cot-gold-noncomm-net-percentile-156w, cot-crude-noncomm-net, cot-crude-noncomm-net-percentile-26w, cot-crude-noncomm-net-percentile-52w, cot-crude-noncomm-net-percentile-156w, cot-jpy-noncomm-net, cot-jpy-noncomm-net-percentile-26w, cot-jpy-noncomm-net-percentile-52w, cot-jpy-noncomm-net-percentile-156w, cot-eur-noncomm-net, cot-eur-noncomm-net-percentile-26w, cot-eur-noncomm-net-percentile-52w, cot-eur-noncomm-net-percentile-156w, cot-treasury10y-noncomm-net, cot-treasury10y-noncomm-net-percentile-26w, cot-treasury10y-noncomm-net-percentile-52w, cot-treasury10y-noncomm-net-percentile-156w, cot-btc-cme-dealer-net, cot-btc-cme-asset-manager-net, cot-btc-cme-leveraged-funds-net, cot-btc-cme-other-reportable-net, cot-btc-cme-nonreportable-net, cot-btc-cme-open-interest, cot-eth-cme-dealer-net, cot-eth-cme-asset-manager-net, cot-eth-cme-leveraged-funds-net, cot-eth-cme-other-reportable-net, cot-eth-cme-nonreportable-net, cot-eth-cme-open-interest, nyfed-sofr, nyfed-sofr-p1, nyfed-sofr-p25, nyfed-sofr-p75, nyfed-sofr-p99, nyfed-sofr-volume, nyfed-bgcr, nyfed-bgcr-p1, nyfed-bgcr-p25, nyfed-bgcr-p75, nyfed-bgcr-p99, nyfed-bgcr-volume, nyfed-tgcr, nyfed-tgcr-p1, nyfed-tgcr-p25, nyfed-tgcr-p75, nyfed-tgcr-p99, nyfed-tgcr-volume, nyfed-effr, nyfed-effr-p1, nyfed-effr-p25, nyfed-effr-p75, nyfed-effr-p99, nyfed-effr-volume, nyfed-obfr, nyfed-obfr-p1, nyfed-obfr-p25, nyfed-obfr-p75, nyfed-obfr-p99, nyfed-obfr-volume, tic-treasury-holdings-total, tic-treasury-holdings-foreign-official, tic-treasury-holdings-japan, tic-treasury-holdings-united-kingd

Parameters2

metric	string	required	Metric name to fetch
format	string	optional	Response format: markdown (default) or json

Raw schema

{
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "enum": [
        "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",
        "treasury-1mo",
        "treasury-1-5mo",
        "treasury-2mo",
        "treasury-4mo",
        "treasury-6mo",
        "treasury-1y",
        "treasury-3y",
        "treasury-7y",
        "treasury-20y",
        "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",
        "cot-spx-noncomm-net",
        "cot-spx-noncomm-net-percentile-26w",
        "cot-spx-noncomm-net-percentile-52w",
        "cot-spx-noncomm-net-percentile-156w",
        "cot-gold-noncomm-net",
        "cot-gold-noncomm-net-percentile-26w",
        "cot-gold-noncomm-net-percentile-52w",
        "cot-gold-noncomm-net-percentile-156w",
        "cot-crude-noncomm-net",
        "cot-crude-noncomm-net-percentile-26w",
        "cot-crude-noncomm-net-percentile-52w",
        "cot-crude-noncomm-net-percentile-156w",
        "cot-jpy-noncomm-net",
        "cot-jpy-noncomm-net-percentile-26w",
        "cot-jpy-noncomm-net-percentile-52w",
        "cot-jpy-noncomm-net-percentile-156w",
        "cot-eur-noncomm-net",
        "cot-eur-noncomm-net-percentile-26w",
        "cot-eur-noncomm-net-percentile-52w",
        "cot-eur-noncomm-net-percentile-156w",
        "cot-treasury10y-noncomm-net",
        "cot-treasury10y-noncomm-net-percentile-26w",
        "cot-treasury10y-noncomm-net-percentile-52w",
        "cot-treasury10y-noncomm-net-percentile-156w",
        "cot-btc-cme-dealer-net",
        "cot-btc-cme-asset-manager-net",
        "cot-btc-cme-leveraged-funds-net",
        "cot-btc-cme-other-reportable-net",
        "cot-btc-cme-nonreportable-net",
        "cot-btc-cme-open-interest",
        "cot-eth-cme-dealer-net",
        "cot-eth-cme-asset-manager-net",
        "cot-eth-cme-leveraged-funds-net",
        "cot-eth-cme-other-reportable-net",
        "cot-eth-cme-nonreportable-net",
        "cot-eth-cme-open-interest",
        "nyfed-sofr",
        "nyfed-sofr-p1",
        "nyfed-sofr-p25",
        "nyfed-sofr-p75",
        "nyfed-sofr-p99",
        "nyfed-sofr-volume",
        "nyfed-bgcr",
        "nyfed-bgcr-p1",
        "nyfed-bgcr-p25",
        "nyfed-bgcr-p75",
        "nyfed-bgcr-p99",
        "nyfed-bgcr-volume",
        "nyfed-tgcr",
        "nyfed-tgcr-p1",
        "nyfed-tgcr-p25",
        "nyfed-tgcr-p75",
        "nyfed-tgcr-p99",
        "nyfed-tgcr-volume",
        "nyfed-effr",
        "nyfed-effr-p1",
        "nyfed-effr-p25",
        "nyfed-effr-p75",
        "nyfed-effr-p99",
        "nyfed-effr-volume",
        "nyfed-obfr",
        "nyfed-obfr-p1",
        "nyfed-obfr-p25",
        "nyfed-obfr-p75",
        "nyfed-obfr-p99",
        "nyfed-obfr-volume",
        "tic-treasury-holdings-total",
        "tic-treasury-holdings-foreign-official",
        "tic-treasury-holdings-japan",
        "tic-treasury-holdings-united-kingdom",
        "tic-treasury-holdings-china",
        "tic-treasury-holdings-belgium",
        "tic-treasury-holdings-cayman-islands",
        "tic-treasury-holdings-luxembourg",
        "tic-treasury-holdings-canada",
        "tic-treasury-holdings-ireland",
        "tic-treasury-holdings-france",
        "tic-treasury-holdings-taiwan",
        "tic-net-foreign-purchases-long-term",
        "tic-net-foreign-purchases-treasuries",
        "tic-net-foreign-purchases-agency-bonds",
        "tic-net-foreign-purchases-corporate-bonds",
        "tic-net-foreign-purchases-equities",
        "tic-net-foreign-official-purchases-treasuries"
      ],
      "description": "Metric name to fetch"
    },
    "format": {
      "type": "string",
      "enum": [
        "json",
        "markdown"
      ],
      "default": "markdown",
      "description": "Response format: markdown (default) or json"
    }
  },
  "required": [
    "metric"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md12 KBView on GitHub

@prereason/mcp

MCP server for PreReason.

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

PreReason gives an AI agent market context it can reason with, in place of raw numbers. One call returns a briefing with the analysis already in it: a signal line, trend direction over several windows, confidence scores, percentile ranks and correlations, and in the deeper briefings a regime label and a plain language narrative. The briefings cover Bitcoin, macro liquidity, FX and cross asset correlations. The catalogue holds 19 live briefings and 212 individual metrics, among them Bitcoin price and momentum, network and miner health, spot Bitcoin ETF flows, corporate Bitcoin treasuries, the Fed balance sheet, M2, net liquidity, Treasury yields and the dollar. It is served over MCP (a remote server and an npm bridge) and over REST, as Markdown or JSON. The catalogue tools need no key, and an agent can get a free key from inside the session: it shows one link, a person approves it, and the key arrives.

Quick Start

Option 1: Claude Desktop, no key needed

Requires Node.js 18+, and nothing else: the bridge has no dependencies.

Add this to claude_desktop_config.json and restart Claude Desktop:

json

{
  "mcpServers": {
    "prereason": {
      "command": "npx",
      "args": ["-y", "@prereason/mcp"],
      "env": { "PREREASON_CLIENT": "claude-desktop" }
    }
  }
}

The catalogue tools work at once. The first time a briefing needs a key, the bridge asks for access: ask Claude for any briefing and the answer starts with Approve at https://www.prereason.com/claim/PR-XXXX-XXXX. Open the link, sign in or create a free account, click Approve. The key arrives in the bridge on its own, is saved to ~/.prereason/credentials.json, and the next call works. Nothing is created in your account until you click Approve. If your account already holds as many API keys as it allows, the answer says so instead of looping: revoke a key under Settings on prereason.com and restart Claude, or set PREREASON_API_KEY to a key you already have.

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Already have a key? Add it to the env block as "PREREASON_API_KEY": "pr_live_..." and the bridge never asks.

Option 2: Direct HTTP with an API key (Claude Code, Cursor, Windsurf, Codex, Gemini CLI, VS Code, scripts)

Clients that hold their own config can call the endpoint directly, with the key as a header:

bash

# Claude Code
claude mcp add --transport http prereason https://api.prereason.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

json

{
  "mcpServers": {
    "prereason": {
      "type": "http",
      "url": "https://api.prereason.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf uses serverUrl instead of url; Gemini CLI uses httpUrl; Codex uses url plus bearer_token_env_var in config.toml. No key yet? Point the client at the endpoint without a header to browse the catalogue, then create a key on the website (below) and add the header.

Option 3: Claude.ai and Claude Desktop custom connector

Add PreReason as a custom connector, choose "No sign-in", and where the Request headers section is available add Authorization with the value Bearer YOUR_API_KEY (the word Bearer and the space are part of the value). Sign in support for connectors is being re-tested and is not offered until it is verified.

Get an API Key

Three ways, all free. The hosted server never hands out a key inside a session and never asks for one.

Through this bridge. Run it with no key set: it asks PreReason for access on your behalf and shows one approve_url, in its log and in front of any answer that needs a key. Open it, sign in or create your account, click Approve, and the bridge saves the key, attached to your account and named Agent: <client_name>.

From code, for an agent with no browser. POST https://api.prereason.com/api/agent/claims (no auth), show the human the approve_url, then poll GET https://api.prereason.com/api/agent/claims/{claim_code} with Authorization: Bearer <claim_token> until status is approved. Docs: prereason.com/docs#agent-access.

On the website. Sign up at prereason.com/signup, then Dashboard > Settings > API Keys. Keys start with pr_live_.

5 MCP Tools

Tool	Auth	Description
`list_briefings`	Open	List all 19 pre-reasoned market briefings with tier requirements
`list_metrics`	Open	List every available metric across the bitcoin, macro, calculated and eth 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

19 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, dollar strength, net liquidity
`cross.correlations`	BTC correlation matrix vs macro indicators
`btc.pulse`	Price, 24h change, Bitcoin dominance
`btc.grid-stress`	Epoch pace and difficulty adjustment forecast

Basic - $19.99/mo (6 briefings)

Briefing	Description
`btc.momentum`	200D MA support/resistance with 7d/30d/90d momentum and percentile rankings
`macro.liquidity`	Liquidity indicators with momentum analysis
`btc.on-chain`	Hash rate, difficulty, transactions, active addresses
`cross.breadth`	Breadth across SPY, QQQ and IWM, with Bitcoin's correlation to each
`btc.miner-survival`	Hashprice thermometer with miner stress scoring
`btc.etf-flows`	Spot BTC ETF net daily flows, aggregate AUM, and per-issuer breakdown

Pro - $49.99/mo (7 briefings)

Briefing	Description
`btc.full`	Full Bitcoin analysis: macro overlay, momentum, percentiles, correlations and narrative
`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`	EUR/USD, USD/CNY and dollar strength, with net liquidity and Bitcoin correlations
`btc.energy`	Production cost model with gas input pressure
`btc.treasury`	Corporate Bitcoin treasury intelligence from SEC filings
`macro.rates`	Treasury par yield curve at every maturity, 1M to 30Y, breakeven inflation, 5y5y forward, Germany 10Y

Example Prompts

Once connected, try prompts like:

"Give me the Bitcoin quick check"
"Show me the macro snapshot"
"What does the BTC 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"

Troubleshooting

"Server disconnected" error

Ensure Node.js 18+ is installed: node --version
Check your API key starts with pr_live_
Fully quit Claude Desktop (system tray > Quit) and reopen

Tools not appearing

Restart Claude Desktop after editing config
Verify JSON syntax: node -e "JSON.parse(require('fs').readFileSync('path/to/config','utf8'))"

Windows: "'C:\Program' is not recognized"

If you still see this error, ensure you're using the env block (not --header args) as shown in Quick Start above. If the issue persists, install globally and use node:

Run: npm install -g @prereason/mcp
Use this config (replace YOUR_USER with your Windows username):

json

{
  "mcpServers": {
    "prereason": {
      "command": "node",
      "args": [
        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js"
      ],
      "env": {
        "PREREASON_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Auth errors on get_context / get_metric

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

Other MCP Clients

If your client supports remote HTTP servers, use Quick Start Option 2 above. The stdio bridge package is only needed for clients that require stdio transport (e.g. Claude Desktop).

CLI Usage

bash

# No key: the bridge asks for access and prints one link to approve
npx @prereason/mcp

# Ask for access now, save the key, exit (useful before a first run)
npx @prereason/mcp --login

# Forget the saved key
npx @prereason/mcp --logout

# Use a key from the environment (never asks)
PREREASON_API_KEY=pr_live_... npx @prereason/mcp

# Name the app the bridge runs in, so your dashboard names the connection
PREREASON_CLIENT=claude-desktop npx @prereason/mcp

# --header (backward compatible), a custom credentials file, a custom endpoint
npx @prereason/mcp --header "Authorization:Bearer YOUR_API_KEY"
npx @prereason/mcp --credentials-file /path/to/credentials.json
PREREASON_URL=https://custom.endpoint/mcp npx @prereason/mcp

npx @prereason/mcp --help

Key precedence: PREREASON_API_KEY, then --header, then the credentials file (~/.prereason/credentials.json, or PREREASON_CREDENTIALS_FILE, or --credentials-file), then the claim flow. The file holds the key and which claim issued it, never a claim token. On macOS and Linux the directory is created 0700 and the file 0600; Windows has no mode bits, so the file relies on your profile directory's permissions like every other credential store there.

Claude Desktop extension (.mcpb)

mcpb/manifest.json describes the same bridge as a single click Claude Desktop extension, key optional. To build the bundle: npm install --omit=dev, then npx @anthropic-ai/mcpb pack . from the package directory, and install the resulting .mcpb by double clicking it. Submission to the Claude directory goes through the desktop extension form and is a publisher decision.

No dependencies

The bridge ships its own transports and installs nothing. npm ls on it is one line, npx @prereason/mcp fetches one 23 KB tarball and starts, and the code a security review has to read is the code in this repository.

It used to depend on @modelcontextprotocol/sdk for two classes, a stdio transport and a Streamable HTTP client. That pulled in 91 packages and 25 MB on disk, nearly all of it the SDK server half: Express, Hono, CORS, a rate limiter, an OAuth client and a schema validator, none of which a relay ever calls. lib/stdio.js and lib/streamable-http.js replace the two classes the bridge used, keep their framing and their callbacks, and are covered by the suite under test/.

Privacy Policy

See prereason.com/privacy for data handling practices.

License

MIT

Install

Tools (7)

list_briefingslist_metricsget_healthrequest_accesscheck_accessget_contextget_metric

Configuration

Environment variables

PREREASON_API_KEYsecret

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.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@prereason/mcp@0.4.0"
      ],
      "env": {
        "PREREASON_API_KEY": "<YOUR_PREREASON_API_KEY>",
        "PREREASON_CLIENT": "<YOUR_PREREASON_CLIENT>"
      }
    }
  }
}

com.prereason/mcp (Model Context Protocol) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_briefings

list_metrics

get_health

request_access

check_access

get_context

get_metric

@prereason/mcp

Quick Start

Option 1: Claude Desktop, no key needed

Option 2: Direct HTTP with an API key (Claude Code, Cursor, Windsurf, Codex, Gemini CLI, VS Code, scripts)

Option 3: Claude.ai and Claude Desktop custom connector

Get an API Key

5 MCP Tools

19 Market Briefings

Free (6 briefings)

Basic - $19.99/mo (6 briefings)

Pro - $49.99/mo (7 briefings)

Example Prompts

Troubleshooting

"Server disconnected" error

Tools not appearing

Windows: "'C:\Program' is not recognized"

Auth errors on get_context / get_metric

Other MCP Clients

CLI Usage

Claude Desktop extension (.mcpb)

No dependencies

Links

Privacy Policy

License

Install

Configuration

Related servers