coinmarket

This MCP server exposes access to a subset of the CoinMarketCap API through a small, local service. It provides two tools: get-currency-listings to fetch the latest currency listings and get-quotes to retrieve price quotes for tokens. The get-quotes tool accepts either a slug (for example bitcoin) or a symbol (for example BTC) as an optional string argument, allowing you to query quotes for specific coins. The server uses a CoinMarket API key for authenticated access, so you must provide COINMARKET_API_KEY in your environment when running the service. You can run this server via uv either from your development directory or using a Docker container, depending on your preferred workflow. Once running, you can invoke the two tools to fetch data programmatically or via Claude Desktop integrations that point to the configured mcpServers entry.

Prerequisites:

• Python 3.12 or higher
• uv package manager

Install uv (if you haven't already):

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c irm https://astral.sh/uv/install.ps1 | iex

Set up a development/unpublished server configuration (Claude Desktop):

"mcpServers": {
  "coinmarket_service": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/coinmarket_service",
      "run",
      "coinmarket_service"
    ],
    "env": {
      "COINMARKET_API_KEY": "<insert api key>"
    }
  }
}

Docker option:

# Build the image
docker build -t coinmarket-service .

# Run the container
docker run -e COINMARKET_API_KEY=your_api_key_here coinmarket-service

Claude Desktop with Docker:

"mcpServers": {
  "coinmarket_service": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-e",
      "COINMARKET_API_KEY=<insert api key>",
      "coinmarket-service"
    ]
  }
}

Notes:

• Ensure you have a valid CoinMarket API key and set COINMARKET_API_KEY in your environment before starting the service.
• If you encounter a spawn error for uv, confirm uv is installed and available in your PATH, then restart your terminal or Claude Desktop.
• The directory argument in the uv configuration should point to the repository root that contains pyproject.toml for the CoinMarket service.
• When using Docker, replace <insert api key> with your actual API key or manage it through your environment securely.
• If you are testing locally, you can switch between uv and Docker by updating the mcpServers entry accordingly.