{
  "markdown": "# CoinPaprika MCP Server\n\n[![smithery badge](https://smithery.ai/badge/coinpaprika/coinpaprika)](https://smithery.ai/servers/coinpaprika/coinpaprika)\n\nA Model Context Protocol (MCP) server that provides on-demand access to CoinPaprika's cryptocurrency market data API. Built specifically for AI assistants like Claude to programmatically fetch real-time prices, tickers, exchange data, OHLCV candles, and more with zero configuration.\n\n## TL;DR\n\n```bash\n# Install globally\nnpm install -g @coinpaprika/mcp\n\n# Start the server\ncoinpaprika-mcp\n\n# Or run directly without installation\nnpx @coinpaprika/mcp@latest\n```\n\nCoinPaprika MCP connects Claude to live crypto market data for 12,000+ cryptocurrencies. The free tier needs no API key. [Installation](#installation) | [Configuration](#claude-desktop-integration) | [API Reference](https://api.coinpaprika.com)\n\n> **Prefer zero setup?** Use the hosted MCP server at [mcp.coinpaprika.com](https://mcp.coinpaprika.com): no installation, no API key to start, 31 tools (the 30 here plus `submitFeedback`). See [Hosted server](#hosted-server-no-installation) for transport endpoints.\n\n## What Can You Build?\n\n- **Market Dashboards**: Real-time market overview with global stats, top coins, and volume trends\n- **Coin Analysis Tools**: Deep-dive into any cryptocurrency: price, team, events, exchanges, and markets\n- **Price Trackers**: Track prices across multiple quote currencies with historical OHLCV data\n- **Exchange Comparisons**: Compare trading pairs and volumes across 350+ exchanges\n- **Portfolio Valuations**: Convert an amount between currencies ('0.5 BTC in USD') and track price changes over time\n- **Contract Lookup**: Find tokens by their smart contract address across multiple platforms\n\n## Installation\n\n### Installing via Smithery\n\nTo install CoinPaprika MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/servers/coinpaprika/coinpaprika):\n\n```bash\nnpx -y smithery mcp add coinpaprika/coinpaprika\n```\n\n### Manual Installation\n```bash\n# Install globally (recommended for regular use)\nnpm install -g @coinpaprika/mcp\n\n# Start the server\ncoinpaprika-mcp\n```\n\n## Claude Desktop Integration\n\nAdd the following to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"coinpaprika\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coinpaprika/mcp@latest\"]\n    }\n  }\n}\n```\n\n### With API Key (for paid-tier features)\n\n```json\n{\n  \"mcpServers\": {\n    \"coinpaprika\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coinpaprika/mcp@latest\"],\n      \"env\": {\n        \"COINPAPRIKA_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code Integration\n\n```bash\n# Add as MCP server in Claude Code\nclaude mcp add coinpaprika -- npx @coinpaprika/mcp@latest\n\n# With API key\nCOINPAPRIKA_API_KEY=your-key claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest\n```\n\n### Hosted server (no installation)\n\nIf you prefer zero setup, point any MCP-compatible client directly at the hosted server at [mcp.coinpaprika.com](https://mcp.coinpaprika.com). The landing page provides setup instructions and documentation. The following transport endpoints are available:\n\n| Transport | Endpoint | Use Case |\n|-----------|----------|----------|\n| Streamable HTTP | `https://mcp.coinpaprika.com/streamable-http` | Recommended for most clients |\n| SSE | `https://mcp.coinpaprika.com/sse` | Legacy SSE transport |\n| JSON-RPC | `https://mcp.coinpaprika.com/json-rpc` | Direct JSON-RPC |\n\n> **Note**: These are MCP protocol endpoints. They won't display anything in a browser. Visit [mcp.coinpaprika.com](https://mcp.coinpaprika.com) for the landing page.\n\n```json\n{\n  \"mcpServers\": {\n    \"coinpaprika\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://mcp.coinpaprika.com/streamable-http\"\n    }\n  }\n}\n```\n\n## Available Tools (30)\n\n### Discovery & System\n\n| Tool | Description |\n|------|-------------|\n| `getCapabilities` | Server capabilities, workflow patterns, validation rules, and best practices. **Start here.** |\n| `status` | Server status and configuration |\n| `getGlobal` | Global market overview: total market cap, 24h volume, BTC dominance ('how is the market doing') |\n\n### Coins\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getCoins` | List all coins (id, name, symbol, rank); no prices, use getTickers for prices | none |\n| `getCoinById` | Coin project details (description, team, links); no price, use getTickersById | `coinId` |\n| `getCoinEvents` | Upcoming events for a coin | `coinId` |\n| `getCoinExchanges` | Exchanges listing a coin | `coinId` |\n| `getCoinMarkets` | Markets/exchanges trading a coin ('where to buy X', 'X price on Binance') | `coinId` |\n\n### Tickers & Prices\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getTickers` | Current prices + market caps for top coins by market cap ('top 5 coins', market snapshot) | none |\n| `getTickersById` | Current price, market cap & 24h change of one coin ('BTC price', 'how much is ETH') | `coinId` |\n| `getCoinOHLCVLatest` | Latest full-day OHLC candle (not the live price) | `coinId` |\n| `getCoinOHLCVToday` | Today's in-progress OHLC candle | `coinId` |\n| `priceConverter` | Convert an amount between currencies ('0.5 BTC in USD') | `baseCurrencyId`, `quoteCurrencyId` |\n\n### Exchanges\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getExchanges` | List all exchanges | none |\n| `getExchangeByID` | Exchange details | `exchangeId` |\n| `getExchangeMarkets` | Markets on a specific exchange | `exchangeId` |\n\n### Tags & People\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getTags` | List all tags/categories | none |\n| `getTagById` | Tag details | `tagId` |\n| `getPeopleById` | Person/team member details | `personId` |\n\n### Contracts\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getPlatforms` | List contract platforms | none |\n| `getContracts` | Contracts on a platform | `platformId` |\n| `getTickerByContract` | Token price by contract address (on-chain/DeFi tokens) | `platformId`, `contractAddress` |\n\n### Search & Resolution\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `search` | Search coins/exchanges/people/tags by name; use FIRST to get an id | `q` |\n| `resolveId` | Resolve a name/symbol to canonical id; call FIRST before price tools | `type`, `query` |\n\n### Paid-Tier Tools\n\nThese tools require a paid CoinPaprika API plan. Without an API key, they return guidance directing you to upgrade.\n\n| Tool | Plan Required | Description |\n|------|---------------|-------------|\n| `getCoinOHLCVHistorical` | Starter+ | Historical OHLCV candle data |\n| `getTickersHistoricalById` | Starter+ | Historical ticker snapshots |\n| `getHistoricalTickerByContract` | Starter+ | Historical ticker by contract |\n| `getChangelogIDs` | Starter+ | Changelog of coin ID changes |\n| `keyInfo` | Pro | Verify API key details |\n| `getMappings` | Business | Cross-platform ID mappings |\n\n## API Key Configuration\n\nThe free tier provides access to most tools without any API key. For paid-tier features (historical data, mappings, etc.), set the `COINPAPRIKA_API_KEY` environment variable:\n\n```bash\n# Set via environment variable\nexport COINPAPRIKA_API_KEY=your-api-key-here\ncoinpaprika-mcp\n\n# Or pass inline\nCOINPAPRIKA_API_KEY=your-api-key-here npx @coinpaprika/mcp@latest\n```\n\nGet an API key at [coinpaprika.com/api/pricing](https://coinpaprika.com/api/pricing/).\n\n### Example Usage\n\n```javascript\n// Start by getting capabilities for workflow guidance:\nconst caps = await getCapabilities();\n\n// Get global market overview:\nconst global = await getGlobal();\n\n// Find a coin by name:\nconst results = await search({ q: \"ethereum\" });\n\n// Get detailed coin info:\nconst bitcoin = await getCoinById({ coinId: \"btc-bitcoin\" });\n\n// Get current ticker with USD and BTC quotes:\nconst ticker = await getTickersById({ coinId: \"eth-ethereum\", quotes: \"USD,BTC\" });\n\n// Get OHLCV data for today:\nconst ohlcv = await getCoinOHLCVToday({ coinId: \"btc-bitcoin\" });\n\n// Convert 1 BTC to USD:\nconst conversion = await priceConverter({\n  baseCurrencyId: \"btc-bitcoin\",\n  quoteCurrencyId: \"usd-us-dollars\",\n  amount: 1\n});\n\n// List top 10 exchanges:\nconst exchanges = await getExchanges({ limit: 10 });\n\n// Resolve fuzzy query to exact coin ID:\nconst resolved = await resolveId({ type: \"coin\", query: \"cardano\" });\n```\n\n## Sample Prompts for Claude\n\n- \"What's the current price of Bitcoin and Ethereum? Show me 24h change.\"\n- \"Give me a comprehensive analysis of Cardano: price, team, events, and top exchanges.\"\n- \"Compare the top 5 crypto exchanges by trading volume.\"\n- \"Convert 10 ETH to USD and show the current exchange rate.\"\n- \"Find all coins tagged as 'defi' and show their market caps.\"\n- \"What exchanges list Solana and what trading pairs are available?\"\n- \"Show me the OHLCV data for Bitcoin today.\"\n- \"Search for all coins related to 'layer-2' and rank them by market cap.\"\n- \"Look up the team behind Ethereum. Who are the key people?\"\n- \"Get the ticker for USDT by its Ethereum contract address.\"\n\n## Rate Limits & Performance\n\n- **Free Tier Limits**: 20,000 calls per month, no API key needed. Paid plans start at $99/month for 400,000 calls: https://coinpaprika.com/api/pricing/\n- **Response Time**: 100-500ms for most endpoints\n- **Data Coverage**: 12,000+ cryptocurrencies, 350+ exchanges\n- **Error Handling**: Structured errors with codes, suggestions, and retry guidance\n- **Quota Info**: Running this package yourself, every response carries a `meta.quota` block with the monthly free-tier allowance and the number of calls this server process has made since it started. That count is process-local, not your account balance. The hosted server at `mcp.coinpaprika.com` returns no `meta` block at all, so do not write client code that depends on one\n\n## Troubleshooting\n\n**Common Issues:**\n\n- **Rate limiting**: If receiving `CP429_RATE_LIMIT` errors, back off and retry. The free-tier quota is monthly, not daily, so a sustained 429 means the monthly allowance is spent\n- **Invalid coin ID**: Coin IDs use `symbol-name` format (e.g., `btc-bitcoin`, not `bitcoin` or `BTC`). Use `search` or `resolveId` to find correct IDs\n- **Paid-tier errors**: `CP402_INSUFFICIENT_PLAN` or `CP403_FORBIDDEN` mean the endpoint requires a paid plan. Set `COINPAPRIKA_API_KEY` environment variable\n- **Timeout errors**: Large data requests may take longer, so reduce the `limit` parameter\n- **Network errors**: Check network connectivity, the service requires internet access\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/coinpaprika/coinpaprika-mcp.git\ncd coinpaprika-mcp\n\n# Install dependencies\nnpm install\n\n# Run in development\nnpm start\n\n# Build for production\nnpm run build\n```\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for detailed release notes.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Additional Resources\n\n- [CoinPaprika API Documentation](https://docs.coinpaprika.com)\n- [API Pricing & Plans](https://coinpaprika.com/api/pricing/)\n- [Hosted MCP Server](https://mcp.coinpaprika.com), zero-setup option\n- [DexPaprika MCP](https://www.npmjs.com/package/dexpaprika-mcp), DEX and DeFi data companion package\n- [Model Context Protocol Specification](https://modelcontextprotocol.io)\n- [CoinPaprika](https://coinpaprika.com), comprehensive cryptocurrency market data\n- [DexPaprika](https://dexpaprika.com), onchain DEX analytics\n",
  "bytes": 11789,
  "sha": "d5123fe40318a8b43cdd5f3c4a8a56e18ffa63cbe38b667c69c68ff2032ba27e",
  "repo_slug": "coinpaprika/coinpaprika-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_coinpaprika_coinpaprika_67725ef9/readme"
}