PreReason
Bitcoin and macro market briefings for AI agents: trend signals, regimes, liquidity and ETF flows.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"@prereason/mcp"
]
}
}
}Ausführbare Pakete
0.4.0stdioRemote-Endpunkte
https://api.prereason.com/api/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (7)
🟢list_briefings(tier)
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.
Eingabe-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(category, search)
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.
Eingabe-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(verbose)
Check API health status, version, and available endpoints. No authentication required.
Eingabe-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(client_name, purpose)
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.
Eingabe-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(claim_code, claim_token, access_code)
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.
Eingabe-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(briefing, format, date)
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.
Eingabe-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(metric, format)
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-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. 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.
Eingabe-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#"
}Community
Nachweis