mcp coincap jj

Local 2025-08-31 23:59:01 0

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. Updated to use Coin Cap API v3

? 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 Filesnodejsnpx.cmd",
        "C:UsersYOUR-WINDOWS-USERNAMEreposgithubmcp-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

[
  {
    "description": "Get current price and 24h stats for a cryptocurrency",
    "inputSchema": {
      "properties": {
        "symbol": {
          "description": "Cryptocurrency symbol (e.g., BTC, ETH)",
          "type": "string"
        }
      },
      "required": [
        "symbol"
      ],
      "type": "object"
    },
    "name": "get-crypto-price"
  },
  {
    "description": "Get detailed market analysis including top exchanges and volume distribution",
    "inputSchema": {
      "properties": {
        "symbol": {
          "description": "Cryptocurrency symbol (e.g., BTC, ETH)",
          "type": "string"
        }
      },
      "required": [
        "symbol"
      ],
      "type": "object"
    },
    "name": "get-market-analysis"
  },
  {
    "description": "Get historical price analysis with customizable timeframe",
    "inputSchema": {
      "properties": {
        "days": {
          "default": 7,
          "description": "Number of days to analyze (1-30)",
          "type": "number"
        },
        "interval": {
          "default": "h1",
          "description": "Time interval (m5, m15, m30, h1, h2, h6, h12, d1)",
          "type": "string"
        },
        "symbol": {
          "description": "Cryptocurrency symbol (e.g., BTC, ETH)",
          "type": "string"
        }
      },
      "required": [
        "symbol"
      ],
      "type": "object"
    },
    "name": "get-historical-analysis"
  }
]