Skip to main content

bellwether-mcp

Version: 1.3.8

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 scion-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 scion_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.

Metadata

Release files for bellwether-mcp 1.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bellwether-mcp 1.4.0
File Size Uploaded Provenance Actions
bellwether_mcp-1.4.0.tar.gz 58.1 kB Without provenance Details for bellwether_mcp-1.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bellwether-mcp 1.4.0
File Interpreter ABI Platform Actions
bellwether_mcp-1.4.0-py3-none-any.whl Python 3 none any Details for bellwether_mcp-1.4.0-py3-none-any.whl

Total release size: 138.8 kB

Release files / bellwether_mcp-1.4.0.tar.gz

Download URL bellwether_mcp-1.4.0.tar.gz
Size 58.1 kB
Tags Source
SHA-256 checksum
How to use checksums
d0a94de791b046e8d8ec7f72c6650295d3e859162509ed4d2c3c48023a9d3a0e
BLAKE2b-256 checksum
How to use checksums
fc9c697041f015d820b3f075761250adcd1ed1a839ef886da6b8400db195c06f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / bellwether_mcp-1.4.0-py3-none-any.whl

Download URL bellwether_mcp-1.4.0-py3-none-any.whl
Size 80.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c88612029595727d7c5d54cc436f4e48aa23869c4fd6f0c49d51dc39c59ad288
BLAKE2b-256 checksum
How to use checksums
0ca65f2dda0f3f563c1b8b8196456f368bcee9507fd1168bc019cebefbd3a362
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for bellwether-mcp 1.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page