bellwether-mcp

Version: 1.3.7

Documentation — Installation, deployment, and tool usage are maintained in the official documentation.

Crypto discovery/rankings/market caps (CoinMarketCap), Fed macro and liquidity series with point-in-time vintages (FRED/ALFRED), and the FOMC decision calendar (hike/cut/hold, sourced) — as an MCP tool surface and, through agent-connector-sdk's declarative mcp_tool source adapter, as bounded, checkpointed ingestion streams intended for EG's finance-v1 world-model ontology (feat/finance-core, not yet published — see AGENTS.md).

Not a venue-specific OHLCV feed. CoinMarketCap's general historical OHLCV endpoint documents hourly/daily coverage only, not minute-level exchange candles — pair this package with an emerald-exchange backend for tradable bars and charts.

Sources

Ledger row	Sources	Target class (provisional)
EH-412 (crypto discovery/caps)	CoinMarketCap listings/quotes/global-metrics	Instrument, MacroEvent
EH-412 (Fed macro series)	FRED/ALFRED series/observations, series/vintagedates	EconomicIndicator
EH-412 (FOMC calendar)	Curated dataset, sourced to federalreserve.gov press releases	MacroEvent
EH-422 (macro/liquidity)	FRED named aliases: WALCL, WDTGAL, M2SL, RRPONTSYD, WRESBAL, DGS10, DTWEXBGS	EconomicIndicator

Instrument, EconomicIndicator and MacroEvent are the design doc's own proposed finance-v1 class names (plans/refactor/proposals/FINANCE-INTEGRATION-20260924.md section 4/7). EG's feat/finance-core branch, which owns finance-v1, has not published anything yet as of this package's build — see AGENTS.md "Ontology mapping" before trusting these as final.

Tools

Nine MCP tools, one FastMCP server (bellwether-mcp console script): cmc_listings, cmc_quotes, cmc_global_metrics, fred_macro_series_aliases, fred_series_observations, fred_series_observations_asof, fred_series_vintage_dates, fomc_calendar_list, coinglass_macro_snapshot.

Every tool is keyless except cmc_*, fred_* and coinglass_*, whose credentials are resolved server-side through agent_connector_sdk.credentials (BELLWETHER_CMC_API_KEY, BELLWETHER_FRED_API_KEY, BELLWETHER_COINGLASS_API_KEY) — never accepted as a tool argument. fomc_calendar_list reads a packaged, curated, sourced dataset and needs no credential and no network.

The CoinGlass source serves bounded Bitcoin ETF flows, fear-and-greed observations and Hyperliquid whale positions. Configure the API key and give each source an operator-owned license tag. The source does not establish redistribution rights or claim complete history.

For a matched per-fund flow and AUM, configure the coinglass_etf_fund_flows source with a Bitcoin ETF ticker and license_tag. It joins CoinGlass's daily flow history with its per-ticker AUM history only when their timestamps match. Missing or conflicting AUM refuses the read. Each record retains the capture time of each provider response.

See AGENTS.md for architecture, the ontology-mapping authority, the FOMC dataset's provenance, rate limits, and commands.