Crypto Price & Market Analysis

Crypto Price & Market Analysis MCP Server

A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface. Supports both STDIO and Streamable HTTP transports.

Requirements

• Node.js 22.14+
• CoinCap API key via COINCAP_API_KEY

What's New

• BREAKING: CoinCap v2 API removed. Now uses v3 API exclusively. A COINCAP_API_KEY is required (free tier available at pro.coincap.io/dashboard)
• Streamable HTTP transport added (while keeping STDIO compatibility)
• Runs fully standalone over STDIO and Streamable HTTP - no external registry or runtime required
• 6 new tools: assets-search, market-global, assets-compare, analysis-candlestick, price-convert, assets-info
• Hierarchical tool naming: All tools organized into category-prefixed names (price-*, market-*, assets-*, analysis-*)
• Output schemas: All tools now declare outputSchema with structuredContent for type-safe responses
• MCP best practices: isError flag on validation errors, server description, and asset://{symbol} resource template

Usage

Add this configuration to your Claude Desktop config file:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

If your MCP client requires launching via cmd.exe on Windows:

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Development scripts

pnpm watch         # Development: recompile on change (tsc --watch); pair with `node --watch dist/http.js` for HTTP hot reload
pnpm build         # Compile TypeScript → dist/
pnpm format        # Format source files with Prettier
pnpm lint          # Check for lint errors (ESLint + typescript-eslint)
pnpm lint:fix      # Auto-fix lint errors
pnpm types:check   # TypeScript type-check without emitting files
pnpm test          # Run all tests with Vitest
pnpm test:coverage # Run tests with coverage report (Vitest)
pnpm inspector     # Open MCP inspector for interactive debugging

Run as Streamable HTTP server

You can run the server over HTTP for environments that support MCP over HTTP streaming.

• During development, rebuild and restart on change:

pnpm watch                    # terminal 1: recompile TypeScript
node --watch dist/http.js     # terminal 2: restart the HTTP server on rebuild

• Build and run the HTTP server:

# Build (outputs to dist/)
pnpm build

# Start the HTTP server
pnpm start:http

• Build and run the STDIO server:

# Build (outputs to dist/)
pnpm build

# Start the STDIO server
pnpm start:stdio

The server listens on port 3000 by default (override with PORT). For clients that connect over HTTP (e.g. Claude.ai, Cursor), pass your API key as a query parameter:

http://localhost:3000/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

For remote deployments:

https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

Required: CoinCap API Key

This server uses the CoinCap v3 API, which requires an API key. A free tier is available.

1. Sign up and get your API key at pro.coincap.io/dashboard
2. Add the key to your MCP client configuration:
   • STDIO: via the COINCAP_API_KEY environment variable (see Usage examples above)
   • HTTP: via the COINCAP_API_KEY query parameter in the connection URL (e.g. /mcp?COINCAP_API_KEY=your_key)

Without a valid API key, all tools will return an error with instructions on how to obtain one.

Remote MCP clients

This server runs standalone - clients connect to it directly, with no registry or proxy in between.

• Claude Code (native Streamable HTTP):

claude mcp add --transport http mcp-crypto-price "https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY"

• Claude.ai / Claude Desktop: add a Custom Connector under Settings → Connectors with the remote URL above.
• Cursor and other clients with remote MCP support: point them at the same /mcp URL.
• stdio-only clients: bridge to the remote endpoint with npx -y mcp-remote "https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY", or run locally via npx -y mcp-crypto-price with COINCAP_API_KEY set (see Usage above).

Launch your MCP client to start using the crypto analysis tools.

Tools

price-get

Gets current price and 24h stats for any cryptocurrency, including:

• Current price in USD
• 24-hour price change
• Trading volume
• Market cap
• Market rank

price-convert

Converts a cryptocurrency amount into any fiat currency:

• Uses real-time price data and USD-based exchange rates
• Parameters: symbol (e.g. BTC), amount (default 1), currency (default usd)
• Example: 2.5 BTC in EUR

market-analysis

Provides detailed market analysis including:

• Top 5 exchanges by volume
• Price variations across exchanges
• Volume distribution analysis
• VWAP (Volume Weighted Average Price)

market-global

Provides an overview of the entire cryptocurrency market:

• Total market capitalization across all assets
• 24-hour trading volume
• Number of active cryptocurrencies
• Bitcoin dominance percentage
• Top gainers and losers

market-rates

Returns USD-based conversion rates for fiat currencies and cryptocurrencies:

• All fiat currency rates (USD base)
• Top 10 cryptocurrency rates
• Optional slug parameter (e.g. euro, bitcoin) for a single rate lookup

market-exchanges

Lists top cryptocurrency exchanges ranked by 24h volume:

• Exchange name, rank, and 24h volume in USD
• Number of trading pairs and market share percentage
• Optional exchangeId parameter (e.g. binance) for single exchange details
• Optional limit parameter (1–50, default 10)

assets-top

Lists top cryptocurrencies ranked by market cap, including:

• Current price in USD
• 24-hour price change
• Market cap and rank
• Configurable result count (1–50, default 10)

assets-search

Searches for cryptocurrencies by name or symbol with fuzzy matching:

• Returns matching assets with symbol, name, price, and rank
• Configurable result count (1–50, default 10)
• Example: search "bit" returns Bitcoin, Bitcoin Cash, BitTorrent, etc.

assets-info

Returns detailed metadata for a single cryptocurrency:

• ID, rank, symbol, and name
• Price, 24h change, market cap, and volume
• Circulating supply and max supply
• VWAP (24h)

assets-compare

Compares 2–5 cryptocurrencies side by side:

• Price, 24h change, market cap, volume, and rank for each asset
• Comma-separated symbols (e.g. BTC,ETH,SOL)
• Highlights best performer by 24h change

analysis-historical

Analyzes historical price data with:

• Customizable time intervals (5min to 1 day)
• Support for up to 30 days of historical data
• Price trend analysis
• Volatility metrics
• High/low price ranges

analysis-technical

Returns the latest technical indicators for any cryptocurrency:

• SMA (Simple Moving Average) with period
• EMA (Exponential Moving Average) with period
• RSI (Relative Strength Index) with Overbought/Oversold/Neutral signal
• MACD with signal line, histogram, and Bullish/Bearish label
• VWAP (Volume Weighted Average Price, 24h)

analysis-candlestick

Retrieves OHLCV candlestick data for a cryptocurrency:

• Open, high, low, close, and volume for each candle
• Configurable interval (5m, 15m, 30m, 1h, 2h, 6h, 12h, 1d)
• Supports 1–30 days of historical candles

Resources

The server exposes the following MCP resources:

• info://server — Server name and version metadata
• asset://{symbol} — Cryptocurrency asset information by symbol (e.g. asset://BTC), returned as JSON

Prompts

The server exposes the following MCP prompts that clients can invoke:

Prompt	Args	Description
analyze-crypto	symbol	Comprehensive analysis: price, market, historical trends
compare-cryptocurrencies	symbols	Compare 2-5 cryptos side-by-side
market-overview	—	Global market snapshot: metrics, top assets, top exchanges
crypto-conversion	symbol, amount?, currency?	Convert crypto amount to fiat
exchange-analysis	symbol	Exchange landscape analysis for a crypto
technical-analysis	symbol	Full technical analysis: indicators, candles, trends
crypto-screener	query	Search and screen cryptos for opportunities

Sample Prompts

• "What's the current price of Bitcoin?"
• "Show me market analysis for ETH"
• "Give me the 7-day price history for DOGE"
• "What are the top exchanges trading BTC?"
• "Show me the price trends for SOL with 1-hour intervals"
• "What are the technical indicators for ETH right now?"
• "What's the current EUR to USD exchange rate?"
• "Which crypto exchanges have the highest 24h volume?"
• "Search for cryptocurrencies matching 'sol'"
• "Give me a global overview of the crypto market"
• "Compare BTC, ETH, and SOL side by side"
• "Show me 1-hour candlestick data for BTC over the last 3 days"
• "Convert 2.5 BTC to EUR"
• "Get detailed info about the Ethereum asset"
• "Generate a comprehensive analysis of a cryptocurrency covering price, market, and historical trends"
• "Find all cryptocurrencies with 'bit' in their name and show me their current prices"
• "What's the market cap ranking and circulating supply of Cardano?"
• "Compare the top 3 stablecoins and show which has the highest volume"
• "Show me how Bitcoin has performed over the past 30 days with daily candles"
• "Convert 100 SOL to GBP and show the exchange rate"
• "Give me a full market snapshot: global metrics, top gainers, and BTC dominance"
• "What are the best and worst performing cryptos in the last 24 hours?"
• "Show me 15-minute candlestick data for ETH over the last 2 days"
• "Compare DeFi tokens: UNI, AAVE, COMP, and MKR"
• "What's the VWAP and max supply of Bitcoin?"
• "Search for layer-2 tokens and compare the top results"

License

This project is licensed under the MIT License