Crypto Price & Market Analysis

You can run a streamlined crypto price and market analysis MCP server that fetches data from CoinCap and exposes real-time price, market analysis, and historical trends through a simple MCP interface. It supports both local STDIO execution and a streamable HTTP transport for clients that can consume MCP over HTTP.

How to use

Use an MCP client to load the mcp-crypto-price server and query its capabilities. You can run the server locally and then connect to it from your MCP client to request current prices, market analysis, and historical trends. The server accepts an optional API key to increase rate limits and supports both real-time price data and deeper market insights.

How to install

Prerequisites: make sure Node.js and npm are installed on your system.

# Install dependencies if needed
npm install

# Run in development mode (streamable HTTP transport)
npm run dev

# Build the HTTP bundle (outputs to .smithery/)
npm run build

# Start the HTTP server
npm run start:http

# Build the STDIO bundle (outputs to dist/)
npm run build:stdio

# Start the STDIO server
npm run start:stdio

Configuration and usage notes

Configure your Claude Desktop to connect to the MCP server. Use the following example to load the server as a local STDIO process.

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

Optional: CoinCap API Key

For higher rate limits, provide an API key. The server will prefer v3 when an API key is present and fall back to v2 if needed.

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

Notes on API versions

CoinCap is sunsetting v2. If you provide an API key, the server will attempt to use v3 first and then fall back to v2 if necessary. Without an API key, it uses v2 by default.

Troubleshooting

If the server cannot be contacted by your MCP client, ensure the correct transport is running (HTTP for streamable HTTP or STDIO for local IPC) and that the dev/build/start sequence completed without errors. Check console output from the start commands for the address or port the server exposes.

Available tools

get-crypto-price

Fetches current price and 24h stats for a given cryptocurrency, including current USD price, 24-hour change, volume, market cap, and rank.

get-market-analysis

Provides market overview including top exchanges by volume, cross-exchange price variations, volume distribution, and VWAP.

get-historical-analysis

Analyzes historical price data with customizable intervals, offering trend and volatility metrics along with high/low ranges.