playbooks

home / mcp / coin mcp server

Coin MCP Server

A Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data. This server enables AI-powered applications to retrieve cryptocurrency listings, quotes, and detailed information about various coins.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "longmans-coin_api_mcp": {
      "command": "python",
      "args": [
        "-m",
        "coin_api_mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can query CoinMarketCap data through an MCP Server that exposes cryptocurrency listings, coin details, and market quotes. This server is designed for AI-powered applications to fetch up-to-date crypto information efficiently by using simple MCP endpoints.

How to use

Connect to the Coin MCP Server from your MCP client and use the available endpoints to retrieve data. The server provides three primary capabilities: listing coins with current market data, fetching detailed information about a specific coin, and obtaining latest market quotes for one or more coins.

Prerequisites include having a running Coin MCP Server instance and a valid CoinMarketCap API key. You supply the API key either through an environment variable or by passing it as a startup argument. Once the server is running, you can issue requests to the following endpoints: listing-coins to get a paginated list of active cryptocurrencies with market data, get-coin-info to retrieve detailed information about a specific coin, and get-coin-quotes to fetch the latest market quotes.

How to install

Follow these concrete steps to install and run the server locally.

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

Clone the source, build, and install the package with your Python interpreter.

git clone https://github.com/longmans/coin_api_mcp.git
cd coin_api_mcp
uv build
uv pip install .

Run the server as a Python module.

python -m coin_api_mcp

Configuration and running

Set the CoinMarketCap API key so the server can access data. You can provide it either as an environment variable or via a startup argument.

export COINMARKETCAP_API_KEY=your_api_key_here

Alternatively run the server with the API key provided on startup.

python -m coin_api_mcp --api-key=your_api_key_here

Claude app configuration (example)

If you are configuring Claude to use this MCP server, provide the standard stdio-based command to start the server and set the required environment variable for the API key.

{
  "mcpServers": {
    "coin_api": {
      "command": "python",
      "args": ["-m", "coin_api_mcp"]
    },
    "env": {
      "COINMARKETCAP_API_KEY": "your_api_key_here"
    }
  }
}

Available tools

listing-coins

Fetches a paginated list of active cryptocurrencies with the latest market data. Supports filters like start, limit, price_min/price_max, market_cap_min/market_cap_max, convert, sort, and sort_dir.

get-coin-info

Retrieves detailed information about a specific cryptocurrency. Accepts id, slug, or symbol to identify the coin.

get-coin-quotes

Fetches the latest market quotes for one or more cryptocurrencies using id, slug, or symbol identifiers.