coinpaprika-mcp

Coinpaprika MCP Server

A Model Context Protocol (MCP) server that provides access to cryptocurrency market data using the Coinpaprika API. This server enables Claude and other MCP-compatible clients to retrieve real-time cryptocurrency prices, market statistics, and related information.

Features

🚀 Real-time Cryptocurrency Data

• Current prices and market data for 3000+ cryptocurrencies
• Top coins by market capitalization
• Market statistics and global crypto metrics
• Exchange listings and trading pairs
• Historical events and project information

🔧 MCP Tools

• get_coin_price - Get detailed price and market data for a specific cryptocurrency
• get_top_coins - Retrieve top cryptocurrencies by market cap or other criteria
• get_coin_markets - List markets and exchanges where a coin is traded
• get_exchanges - Get information about cryptocurrency exchanges
• get_global_stats - Fetch global cryptocurrency market statistics
• get_coin_events - Retrieve upcoming and past events for a cryptocurrency
• search_coins - Search for cryptocurrencies by name or symbol

🌐 Proxy Support

• Built-in support for HTTP/HTTPS proxy servers
• Configurable via environment variables
• Perfect for corporate networks or restricted environments

Installation

Using npx (Recommended)

The easiest way to use this MCP server is with npx:

npx coinpaprika-mcp

Global Installation

npm install -g coinpaprika-mcp

Local Installation

npm install coinpaprika-mcp

Usage

Running the Server

Direct execution

npx coinpaprika-mcp

With proxy support

PROXY_URL=http://localhost:9080 npx coinpaprika-mcp
# or
HTTP_PROXY=http://localhost:9080 npx coinpaprika-mcp

MCP Client Configuration

Claude Desktop Configuration

To use this server with Claude Desktop, add the following configuration to your claude_desktop_config.json file:

Location of config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["coinpaprika-mcp"],
      "env": {
        "PROXY_URL": "http://localhost:9080"
      }
    }
  }
}

For global installation:

{
  "mcpServers": {
    "coinpaprika": {
      "command": "coinpaprika-mcp"
    }
  }
}

With proxy support:

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["coinpaprika-mcp"],
      "env": {
        "PROXY_URL": "http://localhost:9080"
      }
    }
  }
}

Other MCP Clients

For other MCP clients that support the stdio transport, use:

coinpaprika-mcp

Available Tools

get_coin_price

Get current price and detailed market data for a specific cryptocurrency.

Parameters:

• coinId (string, required): Coin ID from Coinpaprika (e.g., "btc-bitcoin", "eth-ethereum")

Example:

Get the current price of Bitcoin

get_top_coins

Retrieve top cryptocurrencies by market capitalization or other criteria.

Parameters:

• limit (number, optional): Number of coins to return (default: 10, max: 100)
• sort (string, optional): Sort criteria - "rank", "name", "price_usd", "volume_24h_usd", "market_cap_usd", etc.

Example:

Show me the top 20 cryptocurrencies by market cap

get_coin_markets

Get markets and exchanges where a specific cryptocurrency is traded.

Parameters:

• coinId (string, required): Coin ID from Coinpaprika

Example:

Where can I trade Ethereum?

get_exchanges

Get information about cryptocurrency exchanges.

Example:

Show me the top cryptocurrency exchanges

get_global_stats

Fetch global cryptocurrency market statistics.

Example:

What's the current state of the crypto market?

get_coin_events

Retrieve upcoming and past events for a cryptocurrency.

Parameters:

• coinId (string, required): Coin ID from Coinpaprika

Example:

What events are coming up for Bitcoin?

search_coins

Search for cryptocurrencies by name or symbol.

Parameters:

• query (string, required): Search term (name or symbol)
• limit (number, optional): Number of results to return (default: 10)

Example:

Search for coins related to "ethereum"

Environment Variables

Proxy Configuration

• PROXY_URL: HTTP/HTTPS proxy URL (e.g., http://localhost:9080)
• HTTP_PROXY: Alternative proxy configuration (standard environment variable)

Example Usage with Proxy

# Using PROXY_URL
PROXY_URL=http://proxy.company.com:8080 npx coinpaprika-mcp

# Using HTTP_PROXY
HTTP_PROXY=http://proxy.company.com:8080 npx coinpaprika-mcp

API Information

This server uses the free tier of the Coinpaprika API, which provides:

• ✅ Free access - No API key required
• ✅ 20,000 calls/month - Generous rate limits
• ✅ Real-time data - Up-to-date market information
• ✅ 3000+ cryptocurrencies - Comprehensive coverage
• ✅ Global data - Exchanges, markets, and statistics

For higher usage requirements, consider upgrading to a paid Coinpaprika plan.

Development

Building from Source

git clone https://github.com/kinhunt/coinpaprika-mcp.git
cd coinpaprika-mcp
npm install
npm run build

Development Mode

npm run dev

Testing

# Test the server with a simple client
npx @modelcontextprotocol/inspector coinpaprika-mcp

Troubleshooting

Common Issues

• Connection timeout behind proxy

  • Make sure to set PROXY_URL or HTTP_PROXY environment variable
  • Verify your proxy settings and credentials

• Permission denied errors

  • Try using npx instead of global installation
  • Check Node.js permissions in your system

• Module not found errors

  • Ensure you're using Node.js 18 or higher
  • Try clearing npm cache: npm cache clean --force

Debug Mode

Run with debug logging:

DEBUG=* npx coinpaprika-mcp

Examples

Basic Usage with Claude

After configuring Claude Desktop, you can ask questions like:

• "What's the current price of Bitcoin?"
• "Show me the top 10 cryptocurrencies by market cap"
• "Where can I trade Ethereum?"
• "What's the total cryptocurrency market cap right now?"
• "Search for coins related to 'defi'"
• "What events are coming up for Cardano?"

Example Responses

Bitcoin Price Query:

📈 Bitcoin (BTC)

Current Price: $43,250.123456 USD
Rank: #1
Market Cap: $847,234,567,890
24h Volume: $28,456,789,012

Price Changes:
• 1h: +0.25%
• 24h: +2.15%
• 7d: -1.87%

Supply:
• Circulating: 19,687,431
• Total: 19,687,431  
• Max: 21,000,000

Links:
• Website: https://bitcoin.org
• Explorer: https://blockchair.com/bitcoin

Last Updated: 2024-01-15T10:30:00Z

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

• Fork the repository
• Clone your fork
• Install dependencies: npm install
• Make your changes
• Build the project: npm run build
• Test your changes
• Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Coinpaprika for providing the free cryptocurrency API
• Anthropic for creating the Model Context Protocol
• Claude for MCP client support

Related Projects

• Model Context Protocol - Official MCP documentation
• MCP Servers - Collection of MCP servers
• Coinpaprika API - Cryptocurrency API documentation

Disclaimer: This tool is for informational purposes only. Cryptocurrency investments carry risk, and you should do your own research before making any investment decisions.