market-data-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MARKET_DATA_CMC_API_KEY | No | CoinMarketCap API key, resolved server-side through agent_connector_sdk.credentials for the `cmc_*` tools. Never accepted as a tool argument. | |
| MARKET_DATA_FRED_API_KEY | No | FRED/ALFRED API key, resolved server-side through agent_connector_sdk.credentials for the `fred_*` tools. Never accepted as a tool argument. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Crypto discovery/caps (CoinMarketCap), Fed macro and liquidity series with point-in-time vintages (FRED/ALFRED), and the FOMC decision calendar (hike/cut/hold, sourced). Every tool is keyless except cmc_*, fred_* and coinglass_*, whose credentials are resolved server-side — never accept them as tool arguments. Not a venue-specific OHLCV feed for trading charts: pair with an emerald-exchange backend for that.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| coinglass_macro_snapshotC | Read a bounded snapshot; license rights are supplied by the operator. |
| cmc_listingsB | 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. |
| cmc_quotesB | Latest quote(s) for comma-separated symbols, e.g. |
| cmc_global_metricsC | Aggregate crypto market metrics: total cap, dominance, 24h volume. A macro/liquidity gauge for the crypto market as a whole (EH-422). |
| fred_macro_series_aliasesC | The named macro/liquidity series aliases this package ships (EH-422). |
| fred_series_observationsA | Observations for a FRED series, by raw Today's latest revision by default; pass |
| fred_series_observations_asofB | Point-in-time (ALFRED) observations: the series exactly as known on Reconstructs what a point-in-time backtest would actually have seen —
no look-ahead into revisions published after |
| fred_series_vintage_datesB | Every date this series was revised/published — feed one into |
| fomc_calendar_listC | FOMC decisions as sourced records: date, hike/cut/hold, target range, source_url. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| connector-status | Ask for this connector server's current operational status. |
| bellwether-crypto-analyst | Provide crypto rankings, quotes, aggregate market metrics and on-chain or ETF panels for discovery and macro context. |
| bellwether-macro-analyst | Provide Fed macro and liquidity series, their point-in-time vintages and the FOMC decision record without look-ahead. |
| bellwether-operator | Answer crypto discovery and market-cap, Fed macro and liquidity series, point-in-time vintage and FOMC decision questions from authoritative sources. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| _connector_status_resource | Native resource exposing this server's static status payload. |
| ontology://bellwether-mcp/market_data.ttl | |
| ontology://bellwether-mcp/contracts.ttl | |
| connector-resources | Data sources, ontology mappings and resources of this connector. |
| bellwether-fomc-calendar/SKILL.md | The FOMC decision calendar via the bellwether-mcp MCP server - sourced hike, cut and hold records with date, target range and the Federal Reserve press-release URL, filtered by date range or outcome. Use when the agent must state what the FOMC decided on or between dates. Do NOT use for rate series values (bellwether-macro-series). |
| bellwether-fomc-calendar/_manifest | File listing for bellwether-fomc-calendar |
| bellwether-crypto-reference/SKILL.md | Crypto discovery and market-cap reference data via the bellwether-mcp MCP server - ranked listings, quotes for comma-separated symbols and aggregate market metrics from CoinMarketCap. Use when the agent must rank assets by market cap, quote symbols, or read total cap, dominance and 24h volume as a liquidity gauge. Do NOT use for tradable exchange bars (use an exchange connector), macro series (bellwether-macro-series) or on-chain and ETF panels (bellwether-macro-panel). |
| bellwether-crypto-reference/_manifest | File listing for bellwether-crypto-reference |
| market-data-mcp-development/SKILL.md | Develop, test, gate, and release the market-data-mcp connector. Use this skill when changing the connector's API mappings, MCP tools, packaging, documentation, or repository gates. |
| market-data-mcp-development/_manifest | File listing for market-data-mcp-development |
| bellwether-macro-series/SKILL.md | Fed macro and liquidity series with point-in-time vintages via the bellwether-mcp MCP server (FRED and ALFRED) - the shipped series aliases, observations of the latest revision or a pinned vintage, every revision date of a series, and observations as known on a past date. Use when the agent must read a macro series or reconstruct what a backtest would have seen. Do NOT use for the FOMC decision record (bellwether-fomc-calendar) or crypto data (bellwether-crypto-reference). |
| bellwether-macro-series/_manifest | File listing for bellwether-macro-series |
| bellwether-macro-panel/SKILL.md | Crypto ETF, ETF fund-flow, sentiment and on-chain snapshots via the bellwether-mcp MCP server (CoinGlass). Use when the agent must read a bounded macro-panel dataset with the operator-supplied license tag. Do NOT use for rankings and quotes (bellwether-crypto-reference) or Fed series (bellwether-macro-series). |
| bellwether-macro-panel/_manifest | File listing for bellwether-macro-panel |
TDQS
Scored across 9 tools
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'.
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.
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.
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.