Crypto Price & Market Analysis (JJ Fork)

<a href="https://glama.ai/mcp/servers/4lz96gw3yb">

</a>

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

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

   

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