by longmans
Provides access to CoinMarketCap cryptocurrency data, enabling AI-powered applications to retrieve listings, quotes, and detailed information for a wide range of digital assets.
The server offers a Model Context Protocol interface to CoinMarketCap's public API, allowing AI agents to query active cryptocurrency listings, obtain up‑to‑date market quotes, and fetch comprehensive coin details.
python -m coin_api_mcp
(or via Smithery with the provided npx command).COINMARKETCAP_API_KEY
environment variable or the --api-key
CLI argument.listing-coins
, get-coin-info
, get-coin-quotes
) from your AI application using the MCP protocol.Q: Which programming language is required? A: The server is written in Python; install it using your default Python interpreter.
Q: How do I obtain an API key?
A: Register at the CoinMarketCap website and generate a key, then set COINMARKETCAP_API_KEY
in your environment or pass it with --api-key
.
Q: Can I run the server with Node.js? A: The native implementation is Python, but you can invoke it via Smithery’s npx installer if you prefer a single‑command setup.
Q: What is the maximum number of results per request?
A: Up to 5,000 items can be returned per listing‑coins
call.
Q: How do I debug the server? A: Use the MCP inspector provided with the Model Context Protocol tooling.
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.
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 of items to return.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 of cryptocurrencies 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 cryptocurrency CoinMarketCap IDs.slug
(string, optional): A comma-separated list of cryptocurrency slugs.symbol
(string, optional): One or more comma-separated cryptocurrency symbols.To install Cryptocurrency Data for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install coin-api-mcp --client claude
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, you can run it as a script using:
python -m coin_api_mcp
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:
export COINMARKETCAP_API_KEY=your_api_key_here
python -m coin_api_mcp --api-key=your_api_key_here
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 see any issue, you may want to use the full path for the Python interpreter you are using. You can do a which python
to find out the exact path if needed.
Remember to set the COINMARKETCAP_API_KEY environment variable or provide it via the --api-key argument.
You can use the MCP inspector to debug the server
We encourage contributions to help expand and improve Coin MCP Server. Whether you want to add new search capabilities, enhance existing functionality, or improve documentation, your input is valuable.
For examples of other MCP servers and implementation patterns, see: https://github.com/modelcontextprotocol/servers
Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make Coin MCP Server even more powerful and useful.
Coin MCP Server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "coin-api-mcp": { "command": "python", "args": [ "-m", "coin_api_mcp" ], "env": { "COINMARKETCAP_API_KEY": "<YOUR_API_KEY>" } } } }
Discover more MCP servers with similar functionality and use cases
by stripe
Enables popular agent frameworks to integrate with Stripe APIs via function calling, providing tools for MCP, Python, and TypeScript.
by goat-sdk
GOAT is the largest agentic finance toolkit for AI agents, enabling them to become economic actors by leveraging blockchains, cryptocurrencies, and wallets.
by financial-datasets
Provides AI assistants with tools to retrieve income statements, balance sheets, cash flow statements, stock prices, market news, and crypto information via the Model Context Protocol.
by razorpay
Enables seamless interaction with Razorpay APIs via Model Context Protocol, allowing developers and AI agents to capture payments, manage orders, process refunds, handle settlements, and more through a unified MCP interface.
by armorwallet
Armor Crypto MCP provides a unified interface for AI agents to interact with the crypto ecosystem, including wallet management, swaps, staking, and multi-chain operations.
by alpacahq
Alpaca’s MCP server lets you trade stocks and options, analyze market data, and build strategies through Alpaca's Trading API.
by XeroAPI
Provides a bridge between the Model Context Protocol and Xero's API, enabling standardized access to Xero accounting and business features.
by kukapay
Integrates the Freqtrade cryptocurrency trading bot with an MCP server, exposing the bot's REST API as tools that AI agents can call for fully automated trading operations.
by kukapay
Offers over 50 cryptocurrency technical analysis indicators and corresponding trading strategies, enabling AI agents and developers to assess market trends and generate buy, hold, or sell signals.