@agnthub/mcp-market-data

Production crypto market-data MCP server. Covers spot prices, OHLCV candles, historical prices, trending, categories, global stats, DEX pool data, and cross-chain tokens. Works with zero keys (degraded) and scales up to full coverage with one or more provider API keys.

Designed for the agnthub platform but speaks the stock Model Context Protocol so it runs under any MCP client.

Providers

| Provider | Key required | Gives you | |---|---|---| | CoinGecko | Free demo key, optional Pro | price, snapshot, ohlcv, historical, search, trending, list, categories, token-by-address | | GeckoTerminal | Optional (CG key unlocks higher rate) | pools, pool-ohlcv, DEX tokens | | CoinMarketCap | Optional | redundant price/snapshot/list_top fallback | | CryptoCompare | Optional | minute-level OHLCV, historical | | Binance (public) | None | realtime-fresh prices + ohlcv for top ~450 assets | | DeFiLlama | None | DeFi + stablecoin market stats | | Alternative.me | None | fear & greed index |

Every provider is optional. Install with nothing and you still get DEX pool data, DeFi stats, fear & greed, and prices for top-450 assets. Add a free CoinGecko key and you unlock the full coin universe.

Env

COINGECKO_API_KEY=          # recommended; free at coingecko.com/en/api/pricing
COINGECKO_TIER=             # optional; pro|demo (auto-detected from base URL probe)
COINMARKETCAP_API_KEY=      # optional
CRYPTOCOMPARE_API_KEY=      # optional
GECKOTERMINAL_API_KEY=      # optional; falls back to COINGECKO_API_KEY
ENABLE_BINANCE=true         # default true, no key needed
ENABLE_DEFILLAMA=true       # default true, no key needed
ENABLE_GECKOTERMINAL=true
ENABLE_ALTERNATIVE=true
CACHE_MAX_ITEMS=50000
CACHE_DISABLED=false        # set true in tests for deterministic calls
GLOBAL_INFLIGHT_CAP=32
LOG_LEVEL=info

Modes

mcp-market-data                 # start stdio MCP server
mcp-market-data --validate-keys # probe each provider with current env, print JSON
mcp-market-data --dump-tool-list# list registered tools as JSON
mcp-market-data --version       # print version

Install inside an agnthub agent

The skill catalog entry for market-data points at this package; users don't spawn the binary themselves. On install the agent runner pulls @agnthub/mcp-market-data via npx, wires the user's encrypted keys from the vault into env, and registers the tools with the agent's Claude SDK session.

Development

pnpm --filter @agnthub/mcp-market-data build
pnpm --filter @agnthub/mcp-market-data dev       # tsx watch
pnpm --filter @agnthub/mcp-market-data test

Publishing

Once per release:

pnpm --filter @agnthub/mcp-market-data build
cd apps/mcp-market-data
npm publish --access public    # honors "publishConfig" in package.json

The agent runner invokes npx --yes @agnthub/mcp-market-data on install, so any published version reachable from the agent VM works without further coordination. Pre-publish you can point the install spec at a local tarball: npm pack in the package dir → reference the tarball path in skill_catalog.install.package for smoke testing.