https://github.com/truss44/mcp-crypto-price
A Model Context Protocol (MCP) server that provides real-time cryptocurrency analysis via CoinCap's API. Enables Claude and other MCP clients to fetch crypto prices, analyze market trends, and track historical data.
https://github.com/truss44/mcp-crypto-price
anthropic claude coincap crypto crypto-api cryptocurrency financial-data market-analysis mcp modelcontextprotocol nodejs real-time trading typescript
Last synced: about 1 month ago
JSON representation
A Model Context Protocol (MCP) server that provides real-time cryptocurrency analysis via CoinCap's API. Enables Claude and other MCP clients to fetch crypto prices, analyze market trends, and track historical data.
- Host: GitHub
- URL: https://github.com/truss44/mcp-crypto-price
- Owner: truss44
- License: mit
- Created: 2025-01-02T02:32:17.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-28T10:44:45.000Z (about 2 months ago)
- Last Synced: 2025-05-02T15:09:29.907Z (about 2 months ago)
- Topics: anthropic, claude, coincap, crypto, crypto-api, cryptocurrency, financial-data, market-analysis, mcp, modelcontextprotocol, nodejs, real-time, trading, typescript
- Language: TypeScript
- Homepage:
- Size: 831 KB
- Stars: 24
- Watchers: 1
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Crypto Price & Market Analysis Server - Real-time cryptocurrency price data and market analysis are provided through an easy-to-use interface, leveraging the CoinCap API for comprehensive analysis and historical trends. (APIs and HTTP Requests)
README
# Crypto Price & Market Analysis MCP Server
[](https://smithery.ai/server/@truss44/mcp-crypto-price) [](https://www.npmjs.com/package/mcp-crypto-price)
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.
## Usage
Add this configuration to your Claude Desktop config file:
- **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"mcp-crypto-price": {
"command": "npx",
"args": ["-y", "mcp-crypto-price"]
}
}
}
```
## Optional: CoinCap API Key
For higher rate limits, add an API key to your configuration:
```json
{
"mcpServers": {
"mcp-crypto-price": {
"command": "npx",
"args": ["-y", "mcp-crypto-price"],
"env": {
"COINCAP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
```
> **Important Note**: CoinCap is sunsetting their v2 API. This MCP supports both v2 and v3 APIs:
> - If you provide a `COINCAP_API_KEY`, it will attempt to use the v3 API first, falling back to v2 if necessary
> - Without an API key, it will use the v2 API (which will eventually be discontinued)
> - It's recommended to obtain an API key from [pro.coincap.io/dashboard](https://pro.coincap.io/dashboard) as the v2 API will be completely deactivated in the future
Launch Claude Desktop to start using the crypto analysis tools.
## 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 was inspired by Alex Andru's [coincap-mcp](https://github.com/QuantGeekDev/coincap-mcp) project.
## License
This project is licensed under the MIT License