📌Overview

Purpose: To provide AI-powered applications access to CoinMarketCap's cryptocurrency data, enabling easy retrieval of listings, quotes, and detailed information on various cryptocurrencies.

Overview: Coin MCP Server is a Model Context Protocol server that facilitates interaction with cryptocurrency data via a set of user-friendly tools. It retrieves comprehensive information from CoinMarketCap and supports various filtering and sorting options for enhanced data access.

Key Features:

• Listing Coins: Fetches a paginated list of active cryptocurrencies with the latest market data, allowing users to filter results by price and market cap, and sort by various fields.

• Get Coin Info: Retrieves detailed information about specific cryptocurrencies, assisting in understanding unique characteristics and market performance.

• Get Coin Quotes: Provides the latest market quotes for multiple cryptocurrencies, ensuring users have up-to-date financial information for informed decision-making.

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.

Available Tools

• listing-coins
  Fetches a paginated list of all active cryptocurrencies with the latest market data.

  • start (integer, optional): Offset the start (1-based index) of the paginated list.
  • limit (integer, optional): Number of results to return (default: 10, max: 5000).
  • price_min (number, optional): Minimum USD price to filter results.
  • price_max (number, optional): Maximum USD price to filter results.
  • market_cap_min (number, optional): Minimum market cap to filter results.
  • market_cap_max (number, optional): Maximum market cap to filter results.
  • convert (string, optional): Calculate market quotes in multiple currencies.
  • sort (string, optional): Field to sort the list by.
  • sort_dir (string, optional): Direction to order cryptocurrencies (asc or desc).

• get-coin-info
  Retrieves detailed information about a specific cryptocurrency.

  • id (string, optional): One or more comma-separated CoinMarketCap cryptocurrency IDs.
  • slug (string, optional): A comma-separated list of cryptocurrency slugs.
  • symbol (string, optional): One or more comma-separated cryptocurrency symbols.

• get-coin-quotes
  Fetches the latest market quotes for one or more cryptocurrencies.

  • id (string, optional): One or more comma-separated CoinMarketCap IDs.
  • slug (string, optional): A comma-separated list of cryptocurrency slugs.
  • symbol (string, optional): One or more comma-separated cryptocurrency symbols.

Installation

Installing via Smithery

To install Cryptocurrency Data for Claude Desktop automatically via Smithery:

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

Build the Server

Clone this repository and build and install the program with your default Python interpreter (recommended).

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

After installation, run it as a script:

python -m coin_api_mcp

Configuration

API Key

The server requires a CoinMarketCap API key to function. You can obtain one from CoinMarketCap's website. The API key can be provided in two ways:

1. As an environment variable:

export COINMARKETCAP_API_KEY=your_api_key_here

2. As a command-line argument:

python -m coin_api_mcp --api-key=your_api_key_here

Configure for Claude.app

Add to your Claude settings:

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

If you encounter issues, use the full path for the Python interpreter (find it with which python).

Remember to set the COINMARKETCAP_API_KEY environment variable or provide it via the --api-key argument.

Debugging

You can use the MCP inspector to debug the server.

Contributing

Contributions to expand and improve Coin MCP Server are welcome. Whether adding new features, enhancing functionality, or improving documentation, your help is valuable.

For examples of other MCP servers and implementation patterns, see:
https://github.com/modelcontextprotocol/servers

Pull requests are encouraged!

License

Coin MCP Server is licensed under the MIT License. You are free to use, modify, and distribute the software under its terms. See the LICENSE file in the project repository for details.