mcp-코인캡-jj

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

CoinCap API를 사용하여 포괄적인 암호화폐 분석을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 사용하기 쉬운 인터페이스를 통해 실시간 가격 데이터, 시장 분석 및 과거 추세를 제공합니다. CoinCap API v3을 사용하도록 업데이트되었습니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Crypto Price & Market Analysis MCP Server
truss44
A
security
A
license
A
quality
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.
Last updated 8 days ago
3
660
33
TypeScript
MIT License
Coin MCP Server
longmans
A
security
F
license
A
quality
A Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data, enabling AI applications to retrieve cryptocurrency listings, quotes, and detailed information.
Last updated 6 months ago
3
33
Python
crypto-indicators-mcp
kukapay
-
security
A
license
-
quality
An MCP server providing a range of cryptocurrency technical analysis indicators and strategies.
Last updated 5 months ago
1
66
JavaScript
MIT License
Python Server MCP
stevearagonsite
-
security
A
license
-
quality
A cryptocurrency price service that provides real-time crypto pricing information through an MCP (Model Context Protocol) framework with CoinMarketCap API integration.
Last updated 3 months ago
Python
GPL 3.0

View all related MCP servers

mcp-coincap-jj