A
licenseA
qualityD
maintenanceFinData MCP gives AI agents access to market data, company fundamentals, and macroeconomic indicators via MCP. It covers stocks, ETFs, crypto, forex, commodities, and economic time series.
5
39 PyPI
1
MIT
market-data-mcp
Use this MCP server to retrieve crypto market reference data, Fed/ALFRED macro and liquidity series, FOMC decisions, and licensed CoinGlass macro snapshots.
Discover/rank cryptocurrencies and fetch quotes, global market metrics, and market caps via CoinMarketCap tools.
Read FRED macro/liquidity aliases and observations, including point-in-time ALFRED vintages via as-of dates and vintage-date listings.
List sourced FOMC decisions with date, hike/cut/hold, target range, and source URL, filtered by date or outcome.
Pull bounded CoinGlass snapshots for ETF flows, sentiment, and onchain data using an operator-supplied license tag; optionally join per-fund ETF flows with AUM by ticker.
Use delta modes and source checkpoints on supported tools for bounded/checkpointed ingestion; credentials are resolved server-side, and FOMC data needs no credential or network.
Provides tools for crypto discovery, rankings, market caps, listings, quotes, and global metrics using CoinMarketCap data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@market-data-mcp What's the current total crypto market cap?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
|
EH-412 (Fed macro series) | FRED/ALFRED |
|
EH-412 (FOMC calendar) | Curated dataset, sourced to federalreserve.gov press releases |
|
EH-422 (macro/liquidity) | FRED named aliases: |
|
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.
Related MCP server: MCP Financial Data Gateway
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.
Available Tools
9 toolscmc_global_metricsCmc Global MetricsCRead-onlyIdempotent
Aggregate crypto market metrics: total cap, dominance, 24h volume.
A macro/liquidity gauge for the crypto market as a whole (EH-422).
Inputs: mode, source_checkpoint. Returns: object
cmc_listingsCmc ListingsBRead-onlyIdempotent
Latest cryptocurrency listings ranked by market cap (discovery/caps).
Not a venue-specific OHLCV feed — use an emerald-exchange backend for tradable bars. The API key is resolved server-side, never accepted as an argument.
Inputs: mode, limit, start, source_checkpoint. Returns: object
cmc_quotesCmc QuotesBRead-onlyIdempotent
Latest quote(s) for comma-separated symbols, e.g. "BTC,ETH".
Inputs: symbols (required). Returns: object
coinglass_macro_snapshotCoinglass Macro SnapshotCRead-onlyIdempotent
Read a bounded snapshot; license rights are supplied by the operator.
Inputs: mode (required), dataset (required), license_tag (required), ticker, +1 more. Returns: object
fomc_calendar_listFomc Calendar ListCRead-onlyIdempotent
FOMC decisions as sourced records: date, hike/cut/hold, target range, source_url.
Inputs: mode, limit, since, until, +3 more. Returns: object
fred_macro_series_aliasesFred Macro Series AliasesCRead-onlyIdempotent
The named macro/liquidity series aliases this package ships (EH-422).
Inputs: no named parameters. Returns: object
fred_series_observationsFred Series ObservationsARead-onlyIdempotent
Observations for a FRED series, by raw series_id or a named alias.
Today's latest revision by default; pass realtime_start/
realtime_end (YYYY-MM-DD) to pin a vintage instead — see
fred_series_observations_asof for the common single-date case.
Inputs: mode, alias, limit, offset, +4 more. Returns: object
fred_series_observations_asofFred Series Observations AsofBRead-onlyIdempotent
Point-in-time (ALFRED) observations: the series exactly as known on vintage_date.
Reconstructs what a point-in-time backtest would actually have seen —
no look-ahead into revisions published after vintage_date.
Inputs: vintage_date (required), alias, limit, offset, +1 more. Returns: object
fred_series_vintage_datesFred Series Vintage DatesBRead-onlyIdempotent
Every date this series was revised/published — feed one into *_asof.
Inputs: alias, limit, offset, series_id. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
B3.1/5.0
Scored across 9 tools
Disambiguation4/5
Provider prefixes (cmc_, fred_, fomc_, coinglass_) cleanly partition the surface, and the observations vs. observations_asof pair is explicitly contrasted in its descriptions. The main weak spot is coinglass_macro_snapshot, whose description never says what it snapshots, making it plausibly confusable with cmc_global_metrics as a 'macro gauge'.
Naming Consistency4/5
All names are snake_case and follow a provider_resource pattern, which reads predictably across the set. Minor deviations: some entries are noun-only (cmc_quotes, fomc_calendar_list) while others use a verb-ish tail, and 'asof' is written as one token in an otherwise underscore-separated scheme.
Tool Count5/5
Nine tools is well within a healthy range and each maps to a concrete data product: crypto listings, quotes, aggregate metrics, FRED observations/vintages/aliases, and an FOMC calendar. No obvious filler or redundant duplicate.
Completeness3/5
The FRED side is thorough (latest, point-in-time vintage, revision dates, alias discovery), but there is no way to search for a raw FRED series_id beyond the shipped aliases, and a server named market-data-mcp explicitly has no OHLCV/time-series bars for tradable instruments. coinglass_macro_snapshot is also opaque enough that agents cannot tell what coverage it adds.
Maintenance
ActivityActive
ResponsivenessNo recent community issues
Related MCP Connectors
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Connect AI agents to primary sources - markets, macro, news, earth, network, entities and research.
75 MCP tools: SEC financials, FRED economics, IRS 990, FDA, FX, UK Companies House.
Market data for agents: token prices, DeFi TVL and DEX volume, perp funding, FX, yields, SEC data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 10 financial data tools (market data, economic indicators, news, insider trades, and calendars) via a single MCP layer, enabling any MCP-compatible LLM to access diverse financial data through a unified interface.1MIT
- AlicenseAqualityCmaintenanceProvides live financial data for any LLM agent, including stock quotes, crypto prices, SEC filings, XBRL financials, FX rates, and macro indicators, through ten MCP tools.11115 npm1MIT
- AlicenseNot gradedqualityBmaintenanceInstitutional financial data for AI agents: credit, private markets, options history, filings.MIT