About Coinmarket MCP server
Coinmarket MCP server is a Python-based MCP server for retrieving latest cryptocurrency listings and token quotes. It requires a Coinmarket API key before use.
Key features
- 01Latest currency listings tool
- 02Token quotes by slug or symbol
- 03Resources under the coinmarket:// URI scheme
- 04Docker container support
Use cases
- 01Looking up quotes for tokens such as bitcoin in Claude Desktop
- 02Asking an AI assistant to summarise current crypto listings
MCP support
The server exposes get-currency-listings and get-quotes tools and coinmarket:// resources to MCP clients, backed by the Coinmarket API.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMECoinmarket MCP server
Coinmarket MCP Server
Components
Resources
The server implements a few of the Coinmarket API endpoints
- Custom coinmarket:// URI scheme for accessing individual notes
- Each note resource has a name, description and text/plain mimetype
Tools
The server implements two tools:
get-currency-listings: Get the latest currency listingsget-quotes: Get quotes for tokens- Takes "slug" (example: bitcoin) or "symbol" (example: BTC) as optional string argument
Configuration
Requires coinmarket API key.
Quickstart
Prerequisites
- Python 3.12 or higher
- uv package manager
Install
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"
Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Development/Unpublished Servers Configuration
``` "mcpServers": { "coinmarket_service": { "command": "uv", "args": [ "--directory", "/path/to/coinmarket_service", "run", "coinmarket_service" ], "env": { "COINMARKET_API_KEY": "" } } } ```Docker
You can also run the server using Docker:
# Build the image
docker build -t coinmarket-service .
# Run the container
docker run -e COINMARKET_API_KEY=your_api_key_here coinmarket-service
For Claude Desktop configuration with Docker:
"mcpServers": {
"coinmarket_service": {
"command": "docker",
"args": [
"run",
"--rm",
"-e",
"COINMARKET_API_KEY=<insert api key>",
"coinmarket-service"
]
}
}
Troubleshooting
"spawn uv ENOENT" Error
If you see this error, it means uv is not installed or not in your PATH:
- Install uv following the instructions above
- Restart your terminal/Claude Desktop after installation
- Verify installation: Run
uv --versionin terminal - Update PATH: Make sure uv is in your system PATH
Configuration Issues
- Replace
/path/to/coinmarket_servicewith the actual path to your cloned repository - Ensure your
COINMARKET_API_KEYis valid - The path should point to the root directory containing
pyproject.toml
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.
