{
  "markdown": "# DexPaprika MCP Server\n\n[![smithery badge](https://smithery.ai/badge/coinpaprika/dexpaprika)](https://smithery.ai/servers/coinpaprika/dexpaprika)\n\nA Model Context Protocol (MCP) server that provides on-demand access to DexPaprika's cryptocurrency and DEX data API. Built specifically for AI assistants like Claude to programmatically fetch current token, pool and DEX data with zero configuration.\n\n## TL;DR\n\n```bash\n# Install globally\nnpm install -g dexpaprika-mcp\n\n# Start the server\ndexpaprika-mcp\n\n# Or run directly without installation\nnpx dexpaprika-mcp@latest\n```\n\nDexPaprika MCP connects Claude to live DEX data across multiple blockchains. The free tier needs no API key to start. [Installation](#installation) | [Configuration](#claude-desktop-integration) | [API Reference](https://docs.dexpaprika.com/introduction)\n\n> **Prefer zero setup?** Use the hosted MCP server at [mcp.dexpaprika.com](https://mcp.dexpaprika.com): no installation, no key to start, the same data tools plus `submitFeedback`. See [Hosted server](#hosted-server-no-installation) for transport endpoints.\n\n## Latest release\n\nSee [CHANGELOG.md](CHANGELOG.md) for release notes and migration guides.\n\n## What Can You Build?\n\n- **Token Analysis Tools**: Track price movements, liquidity depth changes, and volume patterns\n- **DEX Comparisons**: Analyze fee structures, volume, and available pools across different DEXes\n- **Liquidity Pool Analytics**: Monitor TVL changes, impermanent loss calculations, and price impact assessments\n- **Market Analysis**: Cross-chain token comparisons, volume trends, and trading activity metrics\n- **Portfolio Trackers**: Current value tracking, historical performance analysis, yield opportunities\n- **Technical Analysis**: Perform advanced technical analysis using historical OHLCV data, including trend identification, pattern recognition, and indicator calculations\n\n## Installation\n\n### Installing via Smithery\n\nTo install DexPaprika for Claude Desktop automatically via [Smithery](https://smithery.ai/servers/coinpaprika/dexpaprika):\n\n```bash\nnpx -y smithery mcp add coinpaprika/dexpaprika\n```\n\n### Manual Installation\n```bash\n# Install globally (recommended for regular use)\nnpm install -g dexpaprika-mcp\n\n# Start the server\ndexpaprika-mcp\n```\n\nThis is a stdio server: it speaks MCP over stdin and stdout and binds no port. On start it writes `DexPaprika MCP server v<version> (tool contract v<contract>) is running...` to stderr and then waits for a client. Run it from an MCP client (Claude Desktop, Cursor, Claude Code) rather than expecting a URL in a browser.\n\n## Video Tutorial\n\nWatch our step-by-step tutorial on setting up and using the DexPaprika MCP server:\n\n[![DexPaprika MCP Tutorial](https://img.youtube.com/vi/rIxFn2PhtvI/0.jpg)](https://www.youtube.com/watch?v=rIxFn2PhtvI)\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    \"dexpaprika\": {\n      \"command\": \"npx\",\n      \"args\": [\"dexpaprika-mcp@latest\"]\n    }\n  }\n}\n```\n\nAfter restarting Claude Desktop, the DexPaprika tools will be available to Claude automatically.\n\n### Optional: using an API key\n\n**This works without a key and always will.** No signup, no card, nothing to\nconfigure. Everything above is the supported way to run it.\n\nA free key raises the monthly allowance and opens streaming on any token rather\nthan the public showcase set. It does **not** raise the per-minute request\nlimit, which is the same on both tiers. Get one at\n[console.dexpaprika.com](https://console.dexpaprika.com); current limits are on\nthe [rate limits page](https://docs.dexpaprika.com/knowledge-base/rate-limits).\n\n```json\n{\n  \"mcpServers\": {\n    \"dexpaprika\": {\n      \"command\": \"npx\",\n      \"args\": [\"dexpaprika-mcp@latest\"],\n      \"env\": {\n        \"DEXPAPRIKA_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**The key goes in on its own. There is no `Bearer` prefix**, and no other scheme\nword either. Paste the key exactly as issued. Almost every other API wants the\nopposite, so this is the single most common reason a working key looks broken.\n\nTwo things worth knowing:\n\n- **A key we cannot read does not produce an error.** The data endpoints ignore\n  an unreadable key and serve you as an anonymous caller, with a normal `200` and\n  real data, so a typo looks exactly like success. Ask the assistant to run\n  `getKeyStatus` after setting one: it reports which plan the API actually sees\n  and names the likely cause when the key is not landing.\n- **Pro customers** additionally set `DEXPAPRIKA_API_BASE_URL` to\n  `https://api-pro.dexpaprika.com`. The host does not change automatically,\n  because sending a free key to that host returns 403.\n\n### Hosted server (no installation)\n\nIf you prefer zero setup, point any MCP-compatible client directly at the hosted server at [mcp.dexpaprika.com](https://mcp.dexpaprika.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.dexpaprika.com/streamable-http` | Recommended for most clients |\n| SSE | `https://mcp.dexpaprika.com/sse` | Legacy SSE transport |\n| JSON-RPC | `https://mcp.dexpaprika.com/json-rpc` | Direct JSON-RPC |\n\n> **Note**: These are MCP protocol endpoints. They won't display anything in a browser. Visit [mcp.dexpaprika.com](https://mcp.dexpaprika.com) for the landing page.\n\n```json\n{\n  \"mcpServers\": {\n    \"dexpaprika\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://mcp.dexpaprika.com/streamable-http\"\n    }\n  }\n}\n```\n\n## Available Tools (17)\n\nThis self-host build registers 17 read tools: 16 market-data tools plus `getKeyStatus`. The hosted server at `mcp.dexpaprika.com` registers its own set including `submitFeedback`. Verify either with a live `tools/list`.\n\n### Discovery\n\n| Tool | Description |\n|------|-------------|\n| `getCapabilities` | Server capabilities, workflow patterns, network synonyms, and best practices. **Start here.** |\n| `getNetworks` | List every supported blockchain network (36) |\n| `getStats` | High-level ecosystem stats (total networks, DEXes, pools, tokens) |\n| `search` | Search tokens, pools, and DEXes across ALL networks by name, symbol, or address |\n| `getKeyStatus` | Whether a key is being sent and which plan the API sees. Reads no market data. |\n\n### DEX Operations\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getNetworkDexes` | List DEXes on a specific network | `network` |\n\n### Pool Operations\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getNetworkPools` | **PRIMARY**. Get top liquidity pools on a network | `network` |\n| `getDexPools` | Get pools from a specific DEX (rows under `results`, cursor pagination) | `network`, `dex` |\n| `getNetworkPoolsFilter` | Filter pools by volume, transactions, creation time | `network` |\n| `getPoolDetails` | Detailed pool info (price, volume, TVL, tokens) | `network`, `pool_address` |\n| `getPoolOHLCV` | Historical OHLCV candle data | `network`, `pool_address`, `start` |\n| `getPoolTransactions` | Recent transactions/trades for a pool | `network`, `pool_address` |\n\n### Token Operations\n\n| Tool | Description | Required Parameters |\n|------|-------------|---------------------|\n| `getTokenDetails` | Detailed token information | `network`, `token_address` |\n| `getTokenPools` | Liquidity pools containing a token (network-scoped filter, `results` + cursor pagination) | `network`, `token_address` |\n| `getTokenMultiPrices` | Batched prices for up to 10 tokens | `network`, `tokens[]` |\n| `getTopTokens` | Top tokens on a network ranked by volume, liquidity, FDV, or 24h price change | `network` |\n| `filterNetworkTokens` | Filter tokens by volume, liquidity, FDV, transactions, and creation time | `network` |\n\n### Example Usage\n\n```javascript\n// Start by getting capabilities for workflow guidance:\nconst caps = await getCapabilities();\n\n// Get details about a specific token:\nconst solanaJupToken = await getTokenDetails({\n  network: \"solana\",\n  token_address: \"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN\"\n});\n\n// Find pools containing a token (returns `results` with cursor pagination;\n// the token filter only works network-scoped):\nconst jupiterPools = await getTokenPools({\n  network: \"solana\",\n  token_address: \"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN\",\n  order_by: \"volume_usd_24h\",\n  limit: 5\n});\n\n// Get top pools on Ethereum (returns `results` with cursor pagination):\nconst ethereumPools = await getNetworkPools({\n  network: \"ethereum\",\n  order_by: \"volume_usd_24h\",\n  limit: 10\n});\n\n// Filter pools by volume and creation time:\nconst filteredPools = await getNetworkPoolsFilter({\n  network: \"ethereum\",\n  volume_24h_min: 100000,\n  created_after: 1710806400,\n  sort_by: \"volume_usd_24h\",\n  limit: 20\n});\n\n// Get historical price data:\nconst ohlcvData = await getPoolOHLCV({\n  network: \"ethereum\",\n  pool_address: \"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640\",\n  start: \"2023-01-01\",\n  interval: \"24h\",\n  limit: 30\n});\n\n// Batch prices for multiple tokens (max 10):\nconst prices = await getTokenMultiPrices({\n  network: \"ethereum\",\n  tokens: [\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\"\n  ]\n});\n```\n\n## Sample Prompts for Claude\n\n- \"Analyze the JUP token on Solana. Fetch price, volume, and top liquidity pools.\"\n- \"Compare trading volume between Uniswap V3 and SushiSwap on Ethereum.\"\n- \"Get the 7-day OHLCV data for SOL/USDC on Raydium and plot a price chart.\"\n- \"Find the top 5 pools by liquidity on Fantom network and analyze their fee structures.\"\n- \"Get recent transactions for the ETH/USDT pool on Uniswap and analyze buy vs sell pressure.\"\n- \"Show me the top 10 pools on Ethereum by 24h volume.\"\n- \"Search for all pools containing the ARB token and rank them by volume.\"\n- \"Filter Ethereum pools with >$100K 24h volume created in the last week.\"\n- \"First get all available networks, then show me the top pools on each major network.\"\n\n## Rate Limits & Performance\n\n- **Free tier**: keyless, no signup, at 15 requests per minute. A free API key raises that to 30 requests per minute, raises the monthly quota, and unlocks streaming: register at https://console.dexpaprika.com. Pro is $99/month at 300 requests per minute. One request costs one credit; batch endpoints cost one credit per item. Full docs at https://docs.dexpaprika.com. Monthly quotas change, so read them here rather than from this page: https://dexpaprika.com/api/pricing\n- **Data delay**: up to 15 seconds on the free tier, real-time on Pro\n- **Response Time**: 100-500ms for most endpoints (network dependent)\n- **Error Handling**: Structured errors with codes, suggestions, and retry guidance\n- **OHLCV Data Availability**: Historical data typically available from token/pool creation date\n\n## Troubleshooting\n\n**Common Issues:**\n\n- **Rate limiting**: If receiving `DP429_RATE_LIMIT` errors, implement exponential backoff\n- **Missing data**: Some newer tokens/pools may have incomplete historical data\n- **Timeout errors**: Large data requests may take longer, consider pagination\n- **Network errors**: Check network connectivity, the service requires internet access\n- **OHLCV limitations**: Maximum range between start and end dates is 1 year; use pagination for longer timeframes\n- **Empty OHLCV**: Pool may be too new. Use `getPoolTransactions` instead\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/coinpaprika/dexpaprika-mcp.git\ncd dexpaprika-mcp\n\n# Install dependencies\nnpm install\n\n# Run with auto-restart on code changes\nnpm run watch\n\n# Build for production\nnpm run build\n\n# Run tests\nnpm test\n```\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for detailed release notes and migration guides.\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- [DexPaprika API Documentation](https://docs.dexpaprika.com/introduction)\n- [Hosted MCP Server](https://mcp.dexpaprika.com), zero-setup option\n- [Model Context Protocol Specification](https://modelcontextprotocol.io)\n- [DexPaprika](https://dexpaprika.com) - Comprehensive onchain analytics market data\n- [CoinPaprika](https://coinpaprika.com) - Comprehensive cryptocurrency market data\n",
  "bytes": 12538,
  "sha": "2321dd28d5c6d5dc59e895b443e9015554bf5ebd694a77f64950c3fb885bcb84",
  "repo_slug": "coinpaprika/dexpaprika-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_dexpaprika_dexpaprika_e27e4311/readme"
}