Coinmarket Data Access Module

Crypto Data Access Service

Modules

Endpoints

The service exposes several functionalities mapped from the CoinmarketCap API Documentation - Custom URI scheme: coinmarket:// for locating specific records - Each record unit contains a designation, explanatory text, and content typed as text/plain

Functionalities

The service implements two primary operations: - fetch-asset-listings: Retrieve the most recent enumeration of supported crypto assets - retrieve-asset-quotes: Obtain current price data for specific tokens - Accepts either a unique asset identifier ("slug," e.g., bitcoin) or a ticker symbol ("symbol," e.g., BTC) as an optional string parameter

Configuration Requirements

Operational setup necessitates a valid CoinmarketCap API credential.

Initialization Guide

Prerequisites

• Runtime environment must be Python version 3.12 or newer
• Requires the uv package management utility

Installation Steps

Set up uv if it is not yet present in your environment: bash

Unix-like systems

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows utilizing PowerShell

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Claude Desktop Environment Setup

Configuration path specifics: On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuration for Local/Testing Servers

"mcpServers": { "coinmarket_service": { "command": "uv", "args": [ "--directory", "/path/to/coinmarket_service", "run", "coinmarket_service" ], "env": { "COINMARKET_API_KEY": "" } } }

Containerized Execution (Docker)

Deployment via a container image is supported:

bash

Create the image

docker build -t coinmarket-service .

Launch the container, injecting the key

docker run -e COINMARKET_API_KEY=your_api_key_here coinmarket-service

Configuration for Claude Desktop interaction when using Docker:

"mcpServers": { "coinmarket_service": { "command": "docker", "args": [ "run", "--rm", "-e", "COINMARKET_API_KEY=", "coinmarket-service" ] } }

Troubleshooting Common Issues

Error: "spawn uv ENOENT"

This indicates that the uv utility is missing from your system's executable search path or is not installed.

1. Install uv: Adhere to the installation guidance provided previously.
2. Environment Refresh: Relaunch your terminal session or Claude Desktop application post-installation.
3. Verification: Confirm successful installation by executing uv --version in the command line.
4. Path Adjustment: Ensure the directory containing uv is properly cataloged in your system's PATH variable.

Configuration File Problems

• Ensure the path specified (e.g., /path/to/coinmarket_service) correctly points to the project root containing the pyproject.toml file.
• Validate that the provided COINMARKET_API_KEY credential is both present and valid for API access.