coin_api_mcp

The Coin MCP Server is a Model Context Protocol server that provides access to cryptocurrency data from CoinMarketCap. This server enables AI-powered applications to retrieve cryptocurrency listings, quotes, and detailed information about various coins.

GitHub Stars

33

User Rating

Not Rated

Favorites

0

Views

27

Forks

7

Issues

4

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Python 3.6 or higher
Node.js 18.0.0 or higher
+1 more

Installation

Installation

Prerequisites

Please specify required software and versions:
Python: 3.6 or higher
Node.js: 18.0.0 or higher
npm: 8.0.0 or higher

Installation Steps

1. Install via Smithery

bash
npx -y @smithery/cli install coin-api-mcp --client claude

2. Build the Server

Clone the repository and build and install the program with your default Python interpreter:
bash
git clone https://github.com/longmans/coin_api_mcp.git
cd coin_api_mcp
uv build
uv pip install .

3. Start the Server

bash
python -m coin_api_mcp

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Python version and reinstall dependencies.

Configuration

Configuration

API Key

The server requires a CoinMarketCap API key to function. You can provide it in one of two ways:
1As an environment variable:
bash
export COINMARKETCAP_API_KEY=your_api_key_here
2As a command-line argument:
bash
python -m coin_api_mcp --api-key=your_api_key_here

Configuration Example

json
{
  "mcpServers": {
    "coin-api-mcp": {
      "command": "python",
      "args": ["-m", "coin_api_mcp"],
      "env": {
        "COINMARKETCAP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Examples

Examples

Basic Usage

Example in Python

python
import requests

def get_coin_list():
    response = requests.get('http://localhost:3000/mcp/listing-coins')
    return response.json()

Usage example

coins = get_coin_list() print(coins)

Use Cases

Retrieving cryptocurrency data for AI applications.
Conducting investment analysis based on market data.
Obtaining detailed information about specific cryptocurrencies.
Calculating market quotes in multiple currencies.

Additional Resources