CoinBucha MCP

Ranked cross-signal feed of CoinBucha's leading, non-price Bitcoin indicators. Returns { as_of, btc_price_usd, count, signals[], disclaimer, attribution, source_terms }, where each signal carries id, type, title, value, unit, signal_strength (0-100), direction (tailwind | headwind | neutral), a one-line why, sources[] and its own as_of. Optional filters narrow by strength, direction or signal type. Example: {"min_strength": 70, "direction": "tailwind"} — call with {} for the full ranked list. CoinGecko values carry attribution: "Powered by CoinGecko" and source_terms. Observational data; information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "direction": {
      "enum": [
        "tailwind",
        "headwind",
        "neutral"
      ],
      "type": "string",
      "description": "Keep only signals carrying this direction label"
    },
    "min_strength": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Only signals with strength >= this"
    },
    "signal_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "e.g. ['sovereign_adoption','hiring_velocity']"
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Hiring velocity across tracked Bitcoin and crypto-infrastructure employers, counted from their live ATS boards. Returns { as_of, companies[], note, why, disclaimer }; each company carries company, ticker, category, ats, careers_url, open_roles, open_roles_30d_ago, open_roles_90d_ago and the derived delta_30d, delta_90d and pct_30d. Example: {"company": "coinbase"} for one employer, or {} for every employer tracked. When a company filter matches no tracked employer the response adds coverage_note and tracked_count, saying that the name is outside the tracked set — a limit of coverage, not a finding about whether that company is hiring. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "company": {
      "type": "string",
      "description": "Case-insensitive company filter"
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Nation-state Bitcoin holdings, ranked largest first. Returns { as_of, btc_price_usd, count, sovereigns[], disclaimer, attribution, source_terms }; each row carries country_name, country_code, holdings_btc, status, tier (1 = largest holders), framework, sources[], its own as_of, and source_quality (primary = confirmed against the state's own publication; secondary = reported, not confirmed at source — derived from that row's sources[]). Filter by country name or ISO code, or by tier. Example: {"country": "US"} or {"tier": 1} — call with {} for the full ranking. CoinGecko values carry attribution: "Powered by CoinGecko" and source_terms. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "tier": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Holding tier; 1 = largest holders"
    },
    "country": {
      "type": "string",
      "description": "Country name or ISO code"
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

What changed between two frozen, immutable sovereign-reserve snapshots. Takes optional { from, to } snapshot dates (YYYY-MM-DD); defaults to the two newest. Returns { status, as_of, from, to, counts, added[], removed[], changed[], envelope[], disclaimer, cite }, where each changed row carries country_code, country_name, source_quality { from, to } and changes[] of { field, basis (reported | derived), from, to }. With fewer than two snapshots it returns status "insufficient_snapshots" and diff: null — not an empty diff. Example: {"from": "2026-09-04", "to": "2026-10-01"}. CoinGecko values carry attribution: "Powered by CoinGecko" and source_terms. The whole frozen series in one call: the per-call x402 route /api/paid/sovereign-snapshots (USDC); the per-date snapshot files stay free. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Later snapshot date, YYYY-MM-DD"
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Earlier snapshot date, YYYY-MM-DD"
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Bitcoin held on the balance sheets of tracked public companies, in aggregate and by largest holder. Takes no arguments. Returns { as_of, total_btc, company_count, total_value_usd, top[], why, disclaimer, attribution, source_terms }, where top[] lists the largest holders as { name, symbol, btc }, and listed_exposure[] lists every company in the CoinBucha Listed Bitcoin record as { id, name, ticker, venue, status, btc, page, exposure, record_check } — exposure = { btc_per_share, usd_of_bitcoin_per_share, usd_of_bitcoin_per_1000_usd, btc_per_1000_usd, btc_pct_of_market_cap, as_of { holdings, shares, btc_usd_close, share_close } }, arithmetic on primary filings and closes. Example: {}. CoinGecko values carry attribution: "Powered by CoinGecko" and source_terms. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

RETIRED: this tool is no longer advertised and serves no flow figures. No spot-Bitcoin-ETF flow source is available that is both key-free and permitted to redistribute, so CoinBucha never had a licensed figure to serve here. It remains callable so existing integrations do not break: it takes no arguments and returns { available: false, status, as_of, date_basis, unit, note, disclaimer }, stating the absence explicitly. Read that absence as absent — never as a zero flow. For live signals use scan_signals, get_sovereign_reserves, get_treasury_holdings, get_hiring_signal, get_network_signal or get_daily_brew. Example: {}. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Bitcoin network hashrate level and trend, derived from difficulty (expected, 2016-block epoch). hashrate_eh = difficulty × 2^32 / 600 s for the epoch in force, read from block headers — an expected rate, not a measured one. Takes no arguments. Returns { as_of, hashrate_eh (exahashes per second), pct_30d, pct_90d, hashrate_source, basis, difficulty, difficulty_height, difficulty_source_url, why, disclaimer }. Example: {}. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Next results dates and SEC 10-Q/10-K filing windows of listed bitcoin holders (MSTR, COIN, MARA, HOOD and others): dates and windows from issuer and exchange sources. Takes optional { ticker, days_ahead (1-60, default 60) }. Returns { as_of, today, days_ahead, ticker, count, available, truncated, events[], full, disclaimer, cite, data_contract }; up to 5 events, soonest first, each with ticker, issuer, event_type, event_name, date_status, source_url, checked and either event_date (an issuer-announced date) or window_start/window_end with the SEC rule (a statutory window — never a date). date_status is the record's, verbatim: announced_primary_confirmed, occurred_primary_confirmed or unknown_exact_date_statutory_window. Example: {"ticker": "MSTR"} or {"days_ahead": 14}. Every row with history, rule locators and recorded outcomes: the per-call x402 route /api/paid/calendar (USDC), named with its price in `full`; the same rows stay free as JSON and CSV. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "ticker": {
      "type": "string",
      "maxLength": 12,
      "minLength": 1,
      "description": "One ticker, e.g. MSTR, COIN, 3350"
    },
    "days_ahead": {
      "type": "integer",
      "maximum": 60,
      "minimum": 1,
      "description": "How many days ahead to look (1-60, default 60)"
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

The day's machine-readable digest of the whole signal set — the CoinBucha Daily Brew. Takes no arguments. Returns { date, btc_price_usd, headline, signals_summary[], attribution, source_terms }, one summary line per signal with its strength, direction and one-line why. Example: {}. CoinGecko values carry attribution: "Powered by CoinGecko" and source_terms. Information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Dated strength history for one CoinBucha signal, newest first. Returns { as_of, signal_type, title, unit, count, points[], truncated, available_points, tier_window_points, freshness, why, disclaimer, cite }, where each point carries date, signal_strength (0-100) and direction (tailwind | headwind | neutral). Example: {"signal_type": "network_hashrate", "days": 30}. `signal_type` is one of sovereign_adoption, hiring_velocity, corporate_treasury, network_hashrate. Anonymous and free-tier callers receive the most recent points only and are told so by `truncated` and `available_points`; no figure is ever altered or interpolated to fit a window. Beyond that window: a cut answer carries `more`, naming the per-call x402 route /api/paid/signal-history (every signal's full series in one call, USDC) and whether it is open now; or data_contract.bulk_url names the free CSV of the signal's dated figures. Observational data; information, not financial advice. Every answer carries data_contract { source, as_of, status, corrections_url, license }. This server answers bounded questions, one question, one answer; for bulk, history, backfills and scheduled pulls use the CSVs and datapackage.json at https://coinbucha.com/data.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "signal_type"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "How many of the most recent dated points to return (1-90)"
    },
    "signal_type": {
      "enum": [
        "sovereign_adoption",
        "hiring_velocity",
        "corporate_treasury",
        "network_hashrate"
      ],
      "type": "string",
      "description": "Which signal's history to return"
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Advertised by the server during the last successful anonymous check.

One-shot template that renders the CoinBucha Daily Brew from the live signal set: calls get_daily_brew and scan_signals, then writes a brief giving each signal's strength, direction and one-line why, strongest first, ending with the disclaimer verbatim. Takes no arguments. Describes observable conditions only — information, not financial advice.

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Answers 'does <country> hold Bitcoin, and how much?' from the live dataset: calls get_sovereign_reserves filtered to that country, then states holdings, status, tier, as-of date and the provenance grade of the citations. Reports an untracked country as missing coverage, never as a zero holding. Describes observable conditions only — information, not financial advice.

country

Country name or ISO code, e.g. 'El Salvador' or 'SV' (required)

Advertised by the server during the last successful anonymous check.

Calls get_hiring_signal for one Bitcoin or crypto-infrastructure employer and reports open roles with the 30- and 90-day deltas, distinguishing 'not tracked' from 'tracked and not hiring' using the tool's own coverage sentence. Omit the argument for the whole tracked set. Information, not financial advice.

company

Employer name filter; omit to list every tracked employer

Advertised by the server during the last successful anonymous check.

How every CoinBucha signal is computed: what the 0-100 signal_strength means for each signal type, how the direction label is assigned, and where the underlying figures come from. Markdown. Read this before quoting a strength number.

coinbucha://methodology

MIME type: text/markdown

Advertised by the server during the last successful anonymous check.

Today's machine-readable signal digest: date, BTC price, a headline and one summary line per signal, with the strength, direction and `why` already rendered. Identical to the `get_daily_brew` tool payload — attach this or call that tool, not both. JSON. Information, not financial advice.

coinbucha://daily-brew

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Every tracked state's Bitcoin position, ranked by holdings: country, holdings_btc, status, tier, as-of date, primary-source citations and a per-row provenance grade recomputed from those citations. Identical to `get_sovereign_reserves` with no filter. JSON. Information, not financial advice.

coinbucha://sovereign-reserves

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Aggregate public-company Bitcoin holdings: total BTC, company count, total USD value and the largest holders. Identical to the `get_treasury_holdings` tool payload. JSON. Information, not financial advice.

coinbucha://treasury-holdings

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/united-states

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/china

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/united-kingdom

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/ukraine

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/el-salvador

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/bhutan

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/finland

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/pakistan

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/brazil

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/czech-republic

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/germany

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One dated, immutable snapshot of the sovereign Bitcoin dataset, addressed by date (coinbucha://sovereign/snapshot/2026-09-04). Rows verbatim as frozen — holdings, status, tier, as-of, per-row sources and provenance grade — with the permalink, the JSON and CSV distributions and a cite string. Unlike `coinbucha://sovereign-reserves`, which moves with the daily refresh, a snapshot never changes, so a figure read here stays quotable. List this template to enumerate every frozen date. JSON. Information, not financial advice.

coinbucha://sovereign/snapshot/2026-11-01

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One dated, immutable snapshot of the sovereign Bitcoin dataset, addressed by date (coinbucha://sovereign/snapshot/2026-09-04). Rows verbatim as frozen — holdings, status, tier, as-of, per-row sources and provenance grade — with the permalink, the JSON and CSV distributions and a cite string. Unlike `coinbucha://sovereign-reserves`, which moves with the daily refresh, a snapshot never changes, so a figure read here stays quotable. List this template to enumerate every frozen date. JSON. Information, not financial advice.

coinbucha://sovereign/snapshot/2026-10-01

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One dated, immutable snapshot of the sovereign Bitcoin dataset, addressed by date (coinbucha://sovereign/snapshot/2026-09-04). Rows verbatim as frozen — holdings, status, tier, as-of, per-row sources and provenance grade — with the permalink, the JSON and CSV distributions and a cite string. Unlike `coinbucha://sovereign-reserves`, which moves with the daily refresh, a snapshot never changes, so a figure read here stays quotable. List this template to enumerate every frozen date. JSON. Information, not financial advice.

coinbucha://sovereign/snapshot/2026-09-04

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One tracked state's Bitcoin position, addressed by slug (coinbucha://sovereign/el-salvador). Same row `get_sovereign_reserves` returns for that country, with its provenance grade recomputed from its own citations. List this template to enumerate every tracked state. JSON. Information, not financial advice.

coinbucha://sovereign/{country}

MIME type: application/json

Advertised by the server during the last successful anonymous check.

One dated, immutable snapshot of the sovereign Bitcoin dataset, addressed by date (coinbucha://sovereign/snapshot/2026-09-04). Rows verbatim as frozen — holdings, status, tier, as-of, per-row sources and provenance grade — with the permalink, the JSON and CSV distributions and a cite string. Unlike `coinbucha://sovereign-reserves`, which moves with the daily refresh, a snapshot never changes, so a figure read here stays quotable. List this template to enumerate every frozen date. JSON. Information, not financial advice.

coinbucha://sovereign/snapshot/{date}

MIME type: application/json