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)

Install Node.js: (https://nodejs.org/en)
Install Claude Desktop
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!

Ensure you have Smithery installed for your Claude Desktop app
Run the following command:
smithery install @bujaayjaay/mcp-coincap-jj
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

mcp-coincap-jj

Integrations