Crypto Price & Market Analysis MCP Server (JJ Fork)

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.

📌 About This Fork

This is a fork of the original mcp-crypto-price project by Tracey Russell

✅ What’s changed:

• Updated to use the CoinCap v3 API (as v2 is being sunset).
• Additional improvements and testing planned as time permits.

💡 Shoutout to Coin Cap for their “stake-to-API” subscription model—something I hope more API providers adopt. Subscription fatigue is real!

Package Note: This project is hosted on GitHub as wazzan/mcp-coincap-jj but published to npm as @bujaayjaay/mcp-coincap-jj

🚀 Quick Start (For First-Time Users)

If you’re new to MCP servers, this guide provides step-by-step instructions to get you started.

I tested this on a Windows 11 VM to avoid cluttering my Mac—worked flawlessly!

Claude Desktop Config Locations:

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

🟢 Windows Setup Guide (Same Steps for Any MCP Client)

1. Install Node.js: (https://nodejs.org/en)
2. Install Claude Desktop
3. Configure Claude Desktop:

• Open the hamburger menu (top-left corner) → File → Settings → Developer → Edit Config
• This opens the claude_desktop_config.json file location in Windows Explorer.
• Edit it with your favorite editor and add the following configuration (make sure to include all closing braces!):

Note you can use these same instructions for any other MCP Client

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "npx",
      "args": [
        "-y",
        "@bujaayjaay/mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "INPUT_YOUR_API_KEY_HERE"
      }
    }
  }
}

🛠️ Developer Setup (Local Installation)

For developers and contributors who want to work on the project locally:

🖥️ Option 1: Install From npm

npm install @bujaayjaay/mcp-coincap-jj

🖥️ Option 2: Clone & Run Locally

git clone https://github.com/wazzan/mcp-coincap-jj.git
cd mcp-coincap-jj
npm install        # Install dependencies
npm run build      # Compile TypeScript code
npm test           # Run tests to verify everything works
npm start          # Starts the MCP server locally

MCP Server Config for Local Testing (Windows Example)

• If running locally with npx, use this configuration in Claude Desktop (or any MCP client):

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "C:\\Program Files\\nodejs\\npx.cmd",
        "C:\\Users\\YOUR-WINDOWS-USERNAME\\repos\\github\\mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🔧 Pro Tip: Using absolute paths on Windows ensures a smooth experience, especially when running multiple environments.

Smithery Installation (Optional but Easy)

Although it takes away some of the personal learning experience, it’s a great quick start!

1. Ensure you have Smithery installed for your Claude Desktop app
2. Run the following command:

   smithery install @bujaayjaay/mcp-coincap-jj

3. You'll be prompted to enter your CoinCap API key during setup

UPDATE: CoinCap API Key

You now have to obtain an API Key from CoinCap to use the updated v3 API as v2 is being deprecated: (https://pro.coincap.io/api-docs/)

⚡Usage - 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 is a fork of Tracey Russell's mcp-crypto-price,
• Tracey’s project was inspired by Alex Andru’s coincap-mcp project.

License

This project is licensed under the MIT License