PreReason
Bitcoin and macro market briefings for AI agents: trend signals, regimes, liquidity and ETF flows.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"@prereason/mcp"
]
}
}
}Paquetes ejecutables
0.4.0stdioPuntos de conexión remotos
https://api.prereason.com/api/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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#"
}Comunidad
Evidencia