Skip to content

A Model Context Protocol (MCP) server that provides real-time cryptocurrency analysis via CoinCap's API. Enables Claude and other MCP clients to fetch crypto prices, analyze market trends, and track historical data.

License

Notifications You must be signed in to change notification settings

truss44/mcp-crypto-price

Repository files navigation

Crypto Price & Market Analysis MCP Server

smithery badge NPM Downloads

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.

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"]
    }
  }
}

Optional: CoinCap API Key

For higher rate limits, add an API key to your configuration:

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

Important Note: CoinCap is sunsetting their v2 API. This MCP supports both v2 and v3 APIs:

  • If you provide a COINCAP_API_KEY, it will attempt to use the v3 API first, falling back to v2 if necessary
  • Without an API key, it will use the v2 API (which will eventually be discontinued)
  • It's recommended to obtain an API key from pro.coincap.io/dashboard as the v2 API will be completely deactivated in the future

Launch Claude Desktop to start using the crypto analysis tools.

Tools

get-crypto-price

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

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

get-market-analysis

Provides detailed market analysis including:

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

get-historical-analysis

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

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"

Project Inspiration

This project was inspired by Alex Andru's coincap-mcp project.

License

This project is licensed under the MIT License

About

A Model Context Protocol (MCP) server that provides real-time cryptocurrency analysis via CoinCap's API. Enables Claude and other MCP clients to fetch crypto prices, analyze market trends, and track historical data.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •