PreReason
Bitcoin and macro market briefings for AI agents: trend signals, regimes, liquidity and ETF flows.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"@prereason/mcp"
]
}
}
}実行可能なパッケージ
0.4.0stdioリモートエンドポイント
https://api.prereason.com/api/mcpstreamable-httpできること
ツール一覧
ツール（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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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#"
}コミュニティ
エビデンス