mcp-coincap-jj

# Crypto Price & Market Analysis MCP Server (JJ Fork) [](https://smithery.ai/server/@wazzan/mcp-coincap-jj) [](https://www.npmjs.com/package/@bujaayjaay/mcp-coincap-jj) 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](https://github.com/truss44/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 ```json { "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 ```bash npm install @bujaayjaay/mcp-coincap-jj ``` ##### 🖥️ Option 2: Clone & Run Locally ```bash 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): ```json { "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](https://github.com/truss44/mcp-crypto-price), - Tracey’s project was inspired by Alex Andru’s [coincap-mcp](https://github.com/QuantGeekDev/coincap-mcp) project. ## License This project is licensed under the MIT License