A 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 real-time token, pool, and DEX data with zero configuration. DexPaprika MCP connects Claude to live DEX data across multiple blockchains. No API keys required. Installation | Configuration | API Reference Ne
Add this skill
npx mdskills install coinpaprika/dexpaprika-mcpComprehensive MCP server delivering real-time DEX data across blockchains with excellent documentation and examples
1# DexPaprika MCP Server23A 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 real-time token, pool, and DEX data with zero configuration.45## TL;DR67```bash8# Install globally9npm install -g dexpaprika-mcp1011# Start the server12dexpaprika-mcp1314# Or run directly without installation15npx dexpaprika-mcp16```1718DexPaprika MCP connects Claude to live DEX data across multiple blockchains. No API keys required. [Installation](#installation) | [Configuration](#claude-desktop-integration) | [API Reference](https://docs.dexpaprika.com/introduction)1920## ๐จ Version 1.2.0 Update Highlights2122**New**: Batched token prices tool `getTokenMultiPrices` and enhanced `getNetworkDexes` parameters. See examples below.2324## ๐จ Version 1.1.0 Update Notice2526**Breaking Change**: The global `/pools` endpoint has been removed. If you're upgrading from v1.0.x, please see the [Migration Guide](#migration-from-v10x-to-v110) below.2728## What Can You Build?2930- **Token Analysis Tools**: Track price movements, liquidity depth changes, and volume patterns31- **DEX Comparisons**: Analyze fee structures, volume, and available pools across different DEXes32- **Liquidity Pool Analytics**: Monitor TVL changes, impermanent loss calculations, and price impact assessments33- **Market Analysis**: Cross-chain token comparisons, volume trends, and trading activity metrics34- **Portfolio Trackers**: Real-time value tracking, historical performance analysis, yield opportunities35- **Technical Analysis**: Perform advanced technical analysis using historical OHLCV data, including trend identification, pattern recognition, and indicator calculations3637## Installation3839### Installing via Smithery4041To install DexPaprika for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@coinpaprika/dexpaprika-mcp):4243```bash44npx -y @smithery/cli install @coinpaprika/dexpaprika-mcp --client claude45```4647### Manual Installation48```bash49# Install globally (recommended for regular use)50npm install -g dexpaprika-mcp5152# Verify installation53dexpaprika-mcp --version5455# Start the server56dexpaprika-mcp57```5859The server runs on port 8010 by default. You'll see `MCP server is running at http://localhost:8010` when successfully started.6061## Video Tutorial6263Watch our step-by-step tutorial on setting up and using the DexPaprika MCP server:6465[](https://www.youtube.com/watch?v=rIxFn2PhtvI)6667## Claude Desktop Integration6869Add the following to your Claude Desktop configuration file:7071**macOS**: `~/Library/Application\ Support/Claude/claude_desktop_config.json`72**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`7374```json75{76 "mcpServers": {77 "dexpaprika": {78 "command": "npx",79 "args": ["dexpaprika-mcp"]80 }81 }82}83```8485After restarting Claude Desktop, the DexPaprika tools will be available to Claude automatically.8687## Migration from v1.0.x to v1.1.08889### โ ๏ธ Breaking Changes9091The global `getTopPools` function has been **removed** due to API deprecation.9293### Migration Steps9495**Before (v1.0.x):**96```javascript97// This will no longer work98getTopPools({ page: 0, limit: 10, sort: 'desc', orderBy: 'volume_usd' })99```100101**After (v1.1.0):**102```javascript103// Use network-specific queries instead104getNetworkPools({ network: 'ethereum', page: 0, limit: 10, sort: 'desc', orderBy: 'volume_usd' })105getNetworkPools({ network: 'solana', page: 0, limit: 10, sort: 'desc', orderBy: 'volume_usd' })106107// To query multiple networks, call getNetworkPools for each network108// Or use the search function for cross-network searches109```110111### Benefits of the New Approach112113- **Better Performance**: Network-specific queries are faster and more efficient114- **More Relevant Results**: Get pools that are actually relevant to your use case115- **Improved Scalability**: Better suited for handling large amounts of data across networks116117## Technical Capabilities118119The MCP server exposes these specific endpoints Claude can access:120121### Network Operations122123| Function | Description | Example |124|----------|-------------|---------|125| `getNetworks` | Retrieves all supported blockchain networks and metadata | `{"id": "ethereum", "name": "Ethereum", "symbol": "ETH", ...}` |126| `getNetworkDexes` | Lists DEXes available on a specific network | `{"dexes": [{"id": "uniswap_v3", "name": "Uniswap V3", ...}]}` |127128### Pool Operations129130| Function | Description | Required Parameters | Example Usage |131|----------|-------------|---------------------|--------------|132| `getNetworkPools` | **[PRIMARY]** Gets top pools on a specific network | `network`, `limit` | Get Solana's highest liquidity pools |133| `getDexPools` | Gets top pools for a specific DEX | `network`, `dex` | List pools on Uniswap V3 |134| `getPoolDetails` | Gets detailed pool metrics | `network`, `poolAddress` | Complete metrics for USDC/ETH pool |135| `getPoolOHLCV` | Retrieves time-series price data for various analytical purposes (technical analysis, ML models, backtesting) | `network`, `poolAddress`, `start`, `interval` | 7-day hourly candles for SOL/USDC |136| `getPoolTransactions` | Lists recent transactions in a pool | `network`, `poolAddress` | Last 20 swaps in a specific pool |137138### Token Operations139140| Function | Description | Required Parameters | Output Fields |141|----------|-------------|---------------------|--------------|142| `getTokenDetails` | Gets comprehensive token data | `network`, `tokenAddress` | `price_usd`, `volume_24h`, `liquidity_usd`, etc. |143| `getTokenPools` | Lists pools containing a token | `network`, `tokenAddress` | Returns all pools with liquidity metrics |144| `getTokenMultiPrices` | Batched USD prices for multiple tokens | `network`, `tokens[]` | Array of `{ id, chain, price_usd }` |145| `search` | Finds tokens, pools, DEXes by name/id | `query` | Multi-entity search results |146147### Example Usage148149```javascript150// With Claude, get details about a specific token:151const solanaJupToken = await getTokenDetails({152 network: "solana",153 tokenAddress: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"154});155156// Find all pools for a specific token with volume sorting:157const jupiterPools = await getTokenPools({158 network: "solana",159 tokenAddress: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",160 orderBy: "volume_usd",161 limit: 5162});163164// Get top pools on Ethereum (v1.1.0 approach):165const ethereumPools = await getNetworkPools({166 network: "ethereum",167 orderBy: "volume_usd",168 limit: 10169});170171// Get historical price data for various analytical purposes (technical analysis, ML models, backtesting):172const ohlcvData = await getPoolOHLCV({173 network: "ethereum",174 poolAddress: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", // ETH/USDC on Uniswap V3175 start: "2023-01-01",176 interval: "1d",177 limit: 30178});179180// 1.2.0: Get batched prices for multiple tokens (repeatable tokens query)181const prices = await getTokenMultiPrices({182 network: "ethereum",183 tokens: [184 "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH185 "0xdac17f958d2ee523a2206206994597c13d831ec7" // USDT186 ]187});188```189190## Sample Prompts for Claude191192When working with Claude, try these specific technical queries (updated for v1.1.0):193194- "Analyze the JUP token on Solana. Fetch price, volume, and top liquidity pools."195- "Compare trading volume between Uniswap V3 and SushiSwap on Ethereum."196- "Get the 7-day OHLCV data for SOL/USDC on Raydium and plot a price chart."197- "Find the top 5 pools by liquidity on Fantom network and analyze their fee structures."198- "Get recent transactions for the ETH/USDT pool on Uniswap and analyze buy vs sell pressure."199- "Show me the top 10 pools on Ethereum by 24h volume using getNetworkPools."200- "Search for all pools containing the ARB token and rank them by volume."201- "Retrieve OHLCV data for BTC/USDT to analyze volatility patterns and build a price prediction model."202- "First get all available networks, then show me the top pools on each major network."203204## Rate Limits & Performance205206- **Free Tier Limits**: 60 requests per minute207- **Response Time**: 100-500ms for most endpoints (network dependent)208- **Data Freshness**: Pool and token data updated every 15-30s209- **Error Handling**: 429 status codes indicate rate limiting210- **OHLCV Data Availability**: Historical data typically available from token/pool creation date211212## Troubleshooting213214**Common Issues:**215216- **Rate limiting**: If receiving 429 errors, reduce request frequency217- **Missing data**: Some newer tokens/pools may have incomplete historical data218- **Timeout errors**: Large data requests may take longer, consider pagination219- **Network errors**: Check network connectivity, the service requires internet access220- **OHLCV limitations**: Maximum range between start and end dates is 1 year; use pagination for longer timeframes221222**Migration Issues:**223224- **"getTopPools not found"**: This function has been removed. Use `getNetworkPools` instead with a specific network parameter225- **"410 Gone" errors**: You're using a deprecated endpoint. Check the error message for guidance on the correct endpoint to use226227## Development228229```bash230# Clone the repository231git clone https://github.com/coinpaprika/dexpaprika-mcp.git232cd dexpaprika-mcp233234# Install dependencies235npm install236237# Run with auto-restart on code changes238npm run watch239240# Build for production241npm run build242243# Run tests244npm test245```246247## Changelog248249See [CHANGELOG.md](CHANGELOG.md) for detailed release notes and migration guides.250251## License252253This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.254255## Additional Resources256257- [DexPaprika API Documentation](https://docs.dexpaprika.com/introduction)258- [Model Context Protocol Specification](https://github.com/anthropics/anthropic-cookbook/blob/main/mcp/README.md)259- [DexPaprika](https://dexpaprika.com) - Comprehensive onchain analytics market data260- [CoinPaprika](https://coinpaprika.com) - Comprehensive cryptocurrency market data261
Full transparency โ inspect the skill content before installing.