coin_api_mcp

Coin MCP Server exposes access to CoinMarketCap data through three main tools: listing-coins, get-coin-info, and get-coin-quotes. listing-coins returns a paginated list of active cryptocurrencies with market data and supports filters like price_min, price_max, market_cap_min, market_cap_max, convert, sort, and sort_dir. get-coin-info retrieves detailed information for one or more coins by id, slug, or symbol. get-coin-quotes fetches the latest market quotes for one or more coins, identified by id, slug, or symbol. These tools allow AI applications to fetch up-to-date market data in a structured way via the MCP protocol, enabling dynamic data retrieval for decision making and analysis.

Prerequisites:

• Python 3.8+ installed on your system
• Git installed
• Optional: a CoinMarketCap API key if you plan to query real data

Installation steps:

1. Clone the repository: git clone https://github.com/longmans/coin_api_mcp.git cd coin_api_mcp

2. Build and install (recommended for local development): uv build uv pip install .

3. Run the server directly as a module: python -m coin_api_mcp

Alternative: install via Smithery (if you want to integrate with Claude Desk/Smithery workflow): npx -y @smithery/cli install coin-api-mcp --client claude

Notes:

• If you already have a Python environment, consider using a virtual environment to isolate dependencies.
• After installation, ensure you provide a valid CoinMarketCap API key via COINMARKETCAP_API_KEY env var or the --api-key argument.

• Ensure the COINMARKETCAP_API_KEY environment variable is set or pass the API key via the --api-key option when starting the server.
• In Claude.app, configure the mcpServers.coin_api_mcp entry with command: "python" and args: ["-m", "coin_api_mcp"], and provide COINMARKETCAP_API_KEY in the environment section.
• If you encounter issues locating the correct Python interpreter, you can use the full path to your Python executable (e.g., /usr/bin/python3) in the command.
• The server exposes three main MCP tools: listing-coins, get-coin-info, and get-coin-quotes. Use appropriate query parameters as documented to filter results.
• For debugging, use the MCP inspector to inspect requests/responses and verify environment configuration.