{"_id":"@bujaayjaay/mcp-coincap-jj","_rev":"3-32a7a03e736f1f878dd7c4e0f8f1aaa2","name":"@bujaayjaay/mcp-coincap-jj","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@bujaayjaay/mcp-coincap-jj","version":"1.0.0","keywords":["mcp","modelcontextprotocol","claude","crypto","cryptocurrency","coincap","price","market-analysis","trading","finance"],"author":{"name":"wazzan"},"license":"MIT","_id":"@bujaayjaay/mcp-coincap-jj@1.0.0","maintainers":[{"name":"wazzan","email":"bujaayjaay@gmail.com"}],"homepage":"https://github.com/wazzan/mcp-coincap-jj","bugs":{"url":"https://github.com/wazzan/mcp-coincap-jj/issues"},"bin":{"mcp-coincap-jj":"dist/index.js"},"dist":{"shasum":"6de41ac662f976a808145c7f7c9936370ed2a927","tarball":"https://registry.npmjs.org/@bujaayjaay/mcp-coincap-jj/-/mcp-coincap-jj-1.0.0.tgz","fileCount":15,"integrity":"sha512-YLqxCk/RzCtj4H6sILxQL6ZXd9HQrRVjJ5dqcQFCp0KR8n96EtvAVK/8KIxIQ8hkQHeeNJ714Kool6uYOTa6CA==","signatures":[{"sig":"MEYCIQChztMLz3AlZUCkWo6m7PmUluFi8QHkufGA33Yj09v+CAIhAJ51uP5wwZ6X0uhDFRjeZhJCqEwR3kPrdLKYAw9EUjeC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34957},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"b9c5abd99c74b6dcb662009d4df6045440b4eb77","scripts":{"test":"jest src","build":"tsc && shx chmod +x dist/*.js","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector dist/index.js","test:coverage":"jest --coverage src"},"_npmUser":{"name":"wazzan","email":"bujaayjaay@gmail.com"},"repository":{"url":"git+https://github.com/wazzan/mcp-coincap-jj.git","type":"git"},"_npmVersion":"10.9.2","description":"A Model Context Protocol (MCP) server that provides real-time cryptocurrency data and analysis through CoinCap's API v3. Features include price tracking, market analysis, and historical trends. This is a fork of the original repo by truss44, with updates ","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","@modelcontextprotocol/sdk":"^1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","jest":"^29.7.0","ts-jest":"^29.2.5","typescript":"^5.8.2","@types/jest":"^29.5.14","@types/node":"^20.17.24","semantic-release":"^24.2.3","@semantic-release/git":"^10.0.1","@semantic-release/github":"^11.0.1","@semantic-release/changelog":"^6.0.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-coincap-jj_1.0.0_1742163042903_0.540345273006039","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bujaayjaay/mcp-coincap-jj","version":"1.0.1","keywords":["mcp","modelcontextprotocol","claude","crypto","cryptocurrency","coincap","price","market-analysis","trading","finance"],"author":{"name":"wazzan"},"license":"MIT","_id":"@bujaayjaay/mcp-coincap-jj@1.0.1","maintainers":[{"name":"wazzan","email":"bujaayjaay@gmail.com"}],"homepage":"https://github.com/wazzan/mcp-coincap-jj","bugs":{"url":"https://github.com/wazzan/mcp-coincap-jj/issues"},"bin":{"mcp-coincap-jj":"dist/index.js"},"dist":{"shasum":"40ade6dcda84324dc799473ac76b5ae44cfdbf9a","tarball":"https://registry.npmjs.org/@bujaayjaay/mcp-coincap-jj/-/mcp-coincap-jj-1.0.1.tgz","fileCount":14,"integrity":"sha512-ocdGG5Xz2Cfs+AgD5B2YlAkGtosULKoDjLAmJdMZ+4Uc6l4fyj/Qk+R6ZefwBoDt8oSNcQKmh0mVf2zKfzekqQ==","signatures":[{"sig":"MEYCIQCuvc3CK+oNecj1gDo62b4qjqmGzAPrjr2RPk8N5hCfJgIhAOYxXJRhyb4Q2pCzo6/2y4Q+twtrGLw5wLJwWJt7crFo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28245},"main":"./dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"9754403587a416b8c41700e970ec9946701d5d66","scripts":{"test":"jest src","build":"tsc && shx chmod +x dist/*.js","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector dist/index.js","test:coverage":"jest --coverage src"},"_npmUser":{"name":"wazzan","email":"bujaayjaay@gmail.com"},"repository":{"url":"git+https://github.com/wazzan/mcp-coincap-jj.git","type":"git"},"_npmVersion":"11.2.0","description":"A Model Context Protocol (MCP) server that provides real-time cryptocurrency data and analysis through CoinCap's API v3. Features include price tracking, market analysis, and historical trends. This is a fork of the original repo by truss44, with updates ","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","@modelcontextprotocol/sdk":"^1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","jest":"^29.7.0","ts-jest":"^29.2.5","typescript":"^5.8.2","@types/jest":"^29.5.14","@types/node":"^20.17.24","semantic-release":"^24.2.3","@semantic-release/git":"^10.0.1","@semantic-release/github":"^11.0.1","@semantic-release/changelog":"^6.0.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-coincap-jj_1.0.1_1742166642099_0.7400017066429723","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@bujaayjaay/mcp-coincap-jj","version":"1.1.0","description":"A Model Context Protocol (MCP) server that provides real-time cryptocurrency data and analysis through CoinCap's API v3. Features include price tracking, market analysis, and historical trends. This is a fork of the original repo by truss44, with updates ","license":"MIT","author":{"name":"wazzan"},"type":"module","main":"./dist/index.js","exports":{".":"./dist/index.js"},"bin":{"mcp-coincap-jj":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"npm run build","start":"node dist/index.js","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector dist/index.js","test":"jest src","test:coverage":"jest --coverage src"},"dependencies":{"@modelcontextprotocol/sdk":"^1.7.0","zod":"^3.22.4"},"devDependencies":{"@semantic-release/changelog":"^6.0.3","@semantic-release/git":"^10.0.1","@semantic-release/github":"^11.0.1","@types/jest":"^29.5.14","@types/node":"^20.17.24","jest":"^29.7.0","semantic-release":"^24.2.3","shx":"^0.3.4","ts-jest":"^29.2.5","typescript":"^5.8.2"},"engines":{"node":">=18.0.0"},"keywords":["mcp","modelcontextprotocol","claude","crypto","cryptocurrency","coincap","price","market-analysis","trading","finance"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/wazzan/mcp-coincap-jj.git"},"bugs":{"url":"https://github.com/wazzan/mcp-coincap-jj/issues"},"homepage":"https://github.com/wazzan/mcp-coincap-jj","_id":"@bujaayjaay/mcp-coincap-jj@1.1.0","gitHead":"15cde157d855e929e703ffb7f3c1d403bce143fa","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-2BX0nv1fYQ54i2PxvkIGA4eWILbA8Vw0SZgaSFnx5kOGoVASpYkh7I83WYnyEABUvWOsOH+BOsVJxLT8l1Zlhw==","shasum":"b0856e9f69fe89fff4ed75b9f8c6e6ec8d1a9919","tarball":"https://registry.npmjs.org/@bujaayjaay/mcp-coincap-jj/-/mcp-coincap-jj-1.1.0.tgz","fileCount":15,"unpackedSize":37180,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICrl4BcFj6bO7RpxGP9KExxt6DVyV6NMWaZkO4PM1KC8AiEAwORSEPqbTPXDCaLIqO1d09Y5XquVld1rIYQUTh4GnD0="}]},"_npmUser":{"name":"wazzan","email":"bujaayjaay@gmail.com"},"directories":{},"maintainers":[{"name":"wazzan","email":"bujaayjaay@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-coincap-jj_1.1.0_1742172037520_0.603896706078483"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-16T22:10:42.834Z","modified":"2025-03-17T00:40:37.919Z","1.0.0":"2025-03-16T22:10:43.121Z","1.0.1":"2025-03-16T23:10:42.262Z","1.1.0":"2025-03-17T00:40:37.726Z"},"bugs":{"url":"https://github.com/wazzan/mcp-coincap-jj/issues"},"author":{"name":"wazzan"},"license":"MIT","homepage":"https://github.com/wazzan/mcp-coincap-jj","keywords":["mcp","modelcontextprotocol","claude","crypto","cryptocurrency","coincap","price","market-analysis","trading","finance"],"repository":{"type":"git","url":"git+https://github.com/wazzan/mcp-coincap-jj.git"},"description":"A Model Context Protocol (MCP) server that provides real-time cryptocurrency data and analysis through CoinCap's API v3. Features include price tracking, market analysis, and historical trends. This is a fork of the original repo by truss44, with updates ","maintainers":[{"name":"wazzan","email":"bujaayjaay@gmail.com"}],"readme":"# Crypto Price & Market Analysis MCP Server (JJ Fork)\n\n[![smithery badge](https://smithery.ai/badge/@wazzan/mcp-coincap-jj)](https://smithery.ai/server/@wazzan/mcp-coincap-jj)\n[![npm downloads](https://img.shields.io/npm/dt/@bujaayjaay/mcp-coincap-jj.svg)](https://www.npmjs.com/package/@bujaayjaay/mcp-coincap-jj)\n\nA 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.\n\n## 📌 About This Fork\n\nThis is a fork of the original [mcp-crypto-price](https://github.com/truss44/mcp-crypto-price) project by Tracey Russell\n\n✅ What’s changed:\n   - Updated to use the CoinCap v3 API (as v2 is being sunset).\n   - Additional improvements and testing planned as time permits.\n\n💡 Shoutout to Coin Cap for their “stake-to-API” subscription model—something I hope more API providers adopt. Subscription fatigue is real!\n\n> **Package Note**: This project is hosted on GitHub as `wazzan/mcp-coincap-jj` but published to npm as `@bujaayjaay/mcp-coincap-jj`\n\n---\n## 🚀 Quick Start (For First-Time Users)\n\nIf you’re new to MCP servers, this guide provides step-by-step instructions to get you started.\n\nI tested this on a Windows 11 VM to avoid cluttering my Mac—worked flawlessly!\n\nClaude Desktop Config Locations:\n\n- **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n--- \n🟢 **Windows Setup Guide (Same Steps for Any MCP Client)**\n\n1.\tInstall Node.js: (https://nodejs.org/en)\n2.\tInstall Claude Desktop\n3.\tConfigure Claude Desktop:\n   - Open the hamburger menu (top-left corner) → File → Settings → Developer → Edit Config\n   - This opens the claude_desktop_config.json file location in Windows Explorer.\n   - Edit it with your favorite editor and add the following configuration (make sure to include all closing braces!):\n\n> Note you can use these same instructions for any other MCP Client\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-coincap-jj\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@bujaayjaay/mcp-coincap-jj\"\n      ],\n      \"env\": {\n        \"COINCAP_API_KEY\": \"INPUT_YOUR_API_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n## 🛠️  Developer Setup (Local Installation)\n\nFor developers and contributors who want to work on the project locally:\n\n##### 🖥️ Option 1: Install From npm\n\n```bash\nnpm install @bujaayjaay/mcp-coincap-jj\n```\n\n##### 🖥️ Option 2: Clone & Run Locally\n\n```bash\ngit clone https://github.com/wazzan/mcp-coincap-jj.git\ncd mcp-coincap-jj\nnpm install        # Install dependencies\nnpm run build      # Compile TypeScript code\nnpm test           # Run tests to verify everything works\nnpm start          # Starts the MCP server locally\n```\n\nMCP Server Config for Local Testing (Windows Example)\n- If running locally with npx, use this configuration in Claude Desktop (or any MCP client):\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-coincap-jj\": {\n      \"command\": \"cmd.exe\",\n      \"args\": [\n        \"/c\",\n        \"C:\\\\Program Files\\\\nodejs\\\\npx.cmd\",\n        \"C:\\\\Users\\\\YOUR-WINDOWS-USERNAME\\\\repos\\\\github\\\\mcp-coincap-jj\"\n      ],\n      \"env\": {\n        \"COINCAP_API_KEY\": \"YOUR_API_KEY_HERE\"\n      },\n      \"disabled\": false,\n      \"alwaysAllow\": []\n    }\n  }\n}\n```\n🔧 Pro Tip: Using absolute paths on Windows ensures a smooth experience, especially when running multiple environments.\n\n### Smithery Installation (Optional but Easy)\n\nAlthough it takes away some of the personal learning experience, it’s a great quick start!\n\n1. Ensure you have Smithery installed for your Claude Desktop app\n2. Run the following command:\n   ```\n   smithery install @bujaayjaay/mcp-coincap-jj\n   ```\n3. You'll be prompted to enter your CoinCap API key during setup\n\n## UPDATE: CoinCap API Key\n\nYou now have to obtain an API Key from CoinCap to use the updated v3 API as v2 is being deprecated:\n(https://pro.coincap.io/api-docs/)\n\n## ⚡Usage - Tools\n\n#### `get-crypto-price`\n\nGets current price and 24h stats for any cryptocurrency, including:\n- Current price in USD\n- 24-hour price change\n- Trading volume\n- Market cap\n- Market rank\n\n#### `get-market-analysis`\n\nProvides detailed market analysis including:\n- Top 5 exchanges by volume\n- Price variations across exchanges\n- Volume distribution analysis\n- VWAP (Volume Weighted Average Price)\n\n#### `get-historical-analysis`\n\nAnalyzes historical price data with:\n- Customizable time intervals (5min to 1 day)\n- Support for up to 30 days of historical data\n- Price trend analysis\n- Volatility metrics\n- High/low price ranges\n\n## Sample Prompts\n\n- \"What's the current price of Bitcoin?\"\n- \"Show me market analysis for ETH\"\n- \"Give me the 7-day price history for DOGE\"\n- \"What are the top exchanges trading BTC?\"\n- \"Show me the price trends for SOL with 1-hour intervals\"\n\n## Project Inspiration\n\n- This project is a fork of Tracey Russell's [mcp-crypto-price](https://github.com/truss44/mcp-crypto-price),\n- Tracey’s project was inspired by Alex Andru’s [coincap-mcp](https://github.com/QuantGeekDev/coincap-mcp) project.\n\n## License\n\nThis project is licensed under the MIT License","readmeFilename":"README.md"}