Coinmarket MCP Server
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
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
Requires coinmarket API key.
- Python 3.12 or higher
- uv package manager
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"
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": "" } } } ```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"
]
}
}
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 --version
in terminal - Update PATH: Make sure uv is in your system PATH
- Replace
/path/to/coinmarket_service
with the actual path to your cloned repository - Ensure your
COINMARKET_API_KEY
is valid - The path should point to the root directory containing
pyproject.toml