Skip to content

market-data-mcp

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) as an MCP Server for the agent-utilities ecosystem — a typed, deterministic tool surface plus agent-connector-sdk declarative source-adapter presets.

Official documentation

This site is the canonical reference for market-data-mcp, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

market-data-mcp wraps three keyless-by-default data sources with eight consolidated MCP tools:

  • CoinMarketCap — cryptocurrency discovery, rankings and market caps. Not a venue-specific OHLCV feed; pair with an emerald-exchange backend for tradable bars.
  • FRED / ALFRED — Federal Reserve macro and liquidity series, including point-in-time ("as of") vintages via the same REST API's realtime_start/realtime_end parameters.
  • FOMC decision calendar — a curated, sourced dataset (the Fed publishes no JSON API for this), covering every regularly scheduled meeting with a hike/cut/hold outcome, basis-point change, and resulting target range.

Every tool other than fomc_calendar_list requires a server-side-resolved credential (MARKET_DATA_CMC_API_KEY / MARKET_DATA_FRED_API_KEY) — never accepted as a tool argument. This package ships no A2A agent: unlike most fleet packages it is built directly on agent-connector-sdk (not agent-utilities) — see Overview for why.

Explore the documentation

  • :material-rocket-start: Installation — pip, source, and the prebuilt Docker image.
  • Deployment — run the MCP server, Docker Compose, Caddy + Technitium.
  • Usage — the eight MCP tools and the declarative source adapters.
  • Architecture — the agent-connector-sdk pattern and MCP configuration.
  • Concepts — the design-doc ontology mapping this connector targets.

Quick start

pip install market-data-mcp
export MARKET_DATA_CMC_API_KEY=your_coinmarketcap_key
export MARKET_DATA_FRED_API_KEY=your_fred_key
market-data-mcp                    # stdio MCP server (default transport)

See Installation and Deployment for the full matrix (the Docker image, HTTP transports, reverse proxy, DNS).