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 current token, pool and DEX data with zero configuration.
TL;DR
DexPaprika MCP server for real-time crypto token data, DEX trading activity, and DeFi analytics across multiple blockchains.
2026-10-27
스타
115
도구
—
가동 시간
—
# Install globally
npm install -g dexpaprika-mcp
# Start the server
dexpaprika-mcp
# Or run directly without installation
npx dexpaprika-mcp@latest
DexPaprika MCP connects Claude to live DEX data across multiple blockchains. The free tier needs no API key to start. Installation | Configuration | API Reference
Prefer zero setup? Use the hosted MCP server at mcp.dexpaprika.com: no installation, no key to start, the same data tools plus submitFeedback. See Hosted server for transport endpoints.
Latest release
See CHANGELOG.md for release notes and migration guides.
Portfolio Trackers: Current value tracking, historical performance analysis, yield opportunities
Technical Analysis: Perform advanced technical analysis using historical OHLCV data, including trend identification, pattern recognition, and indicator calculations
Installation
Installing via Smithery
To install DexPaprika for Claude Desktop automatically via Smithery:
npx -y smithery mcp add coinpaprika/dexpaprika
Manual Installation
# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp
# Start the server
dexpaprika-mcp
This 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.
Video Tutorial
Watch our step-by-step tutorial on setting up and using the DexPaprika MCP server:
Claude Desktop Integration
Add the following to your Claude Desktop configuration file:
After restarting Claude Desktop, the DexPaprika tools will be available to Claude automatically.
Optional: using an API key
This works without a key and always will. No signup, no card, nothing to
configure. Everything above is the supported way to run it.
A free key raises the monthly allowance and opens streaming on any token rather
than the public showcase set. It does not raise the per-minute request
limit, which is the same on both tiers. Get one at
console.dexpaprika.com; current limits are on
the rate limits page.
The key goes in on its own, as the entire Authorization value. Paste it
exactly as issued, with nothing in front of it. Almost every other API wants
something in front of the key, so this is the single most common reason a
working key looks broken.
Two things worth knowing:
A key we cannot read does not produce an error. The data endpoints ignore
an unreadable key and serve you as an anonymous caller, with a normal 200 and
real data, so a typo looks exactly like success. Ask the assistant to run
getKeyStatus after setting one: it reports which plan the API actually sees
and names the likely cause when the key is not landing.
Dev and Pro customers additionally set DEXPAPRIKA_API_BASE_URL to
https://api-pro.dexpaprika.com, which is also what getTokenOHLCV needs. The host does not change automatically,
because sending a free key to that host returns 403.
Hosted server (no installation)
If you prefer zero setup, point any MCP-compatible client directly at the hosted server at mcp.dexpaprika.com. The landing page provides setup instructions and documentation. The following transport endpoints are available:
Transport
Endpoint
Use Case
Streamable HTTP
https://mcp.dexpaprika.com/streamable-http
Recommended for most clients
SSE
https://mcp.dexpaprika.com/sse
Legacy SSE transport
JSON-RPC
https://mcp.dexpaprika.com/json-rpc
Direct JSON-RPC
Note: These are MCP protocol endpoints. They won't display anything in a browser. Visit mcp.dexpaprika.com for the landing page.
This self-host build registers 20 read tools: 19 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.
Discovery
Tool
Description
getCapabilities
Server capabilities, workflow patterns, network synonyms, and best practices. Start here.
Search tokens, pools, and DEXes across ALL networks by name, symbol, or address
getKeyStatus
Whether a key is being sent and which plan the API sees. Reads no market data.
DEX Operations
Tool
Description
Required Parameters
getNetworkDexes
List DEXes on a specific network
network
Pool Operations
Tool
Description
Required Parameters
getNetworkPools
PRIMARY. Get top liquidity pools on a network
network
getDexPools
Get pools from a specific DEX (rows under results, cursor pagination; paging past the first page needs a key)
network, dex
getNetworkPoolsFilter
Filter pools by volume, transactions, creation time
network
getPoolDetails
Detailed pool info (price, volume, TVL, tokens)
network, pool_address
getPoolOHLCV
Historical OHLCV candle data
network, pool_address, start
getPoolIndicator
RSI, EMA, MACD, Bollinger Bands or VWAP for a pool, computed server-side from its candles. Same plan limits on history and interval as getPoolOHLCV
network, pool_address, indicator
getPoolTransactions
Recent transactions/trades for a pool
network, pool_address
Token Operations
Tool
Description
Required Parameters
getTokenDetails
Detailed token information
network, token_address
getTokenPools
Liquidity pools containing a token (network-scoped filter, results + cursor pagination; paging past the first page needs a key)
network, token_address
getTokenOHLCV
Historical USD OHLCV candles for a token, volume-weighted across every pool it trades in. Requires a Dev or Pro plan on api-pro.dexpaprika.com; keyless and free keys get 403
network, token_address, start
getTokenIndicator
The same indicators on a token's USD candles across every pool it trades in. Requires a Dev or Pro plan on api-pro.dexpaprika.com; keyless and free keys get 403
network, token_address, indicator
getTokenMultiPrices
Batched prices for up to 10 tokens
network, tokens[]
getTopTokens
Top tokens on a network ranked by volume, liquidity, FDV, or 24h price change
network
filterNetworkTokens
Filter tokens by volume, liquidity, FDV, transactions, and creation time
network
Example Usage
// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();
// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
network: "solana",
token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});
// Find pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped). This first page works without
// a key; passing the response's next_cursor back as cursor to fetch a later
// page needs an API key (a free key pages without limit):
const jupiterPools = await getTokenPools({
network: "solana",
token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
order_by: "volume_usd_24h",
limit: 5
});
// Get top pools on Ethereum (first page, returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
network: "ethereum",
order_by: "volume_usd_24h",
limit: 10
});
// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
network: "ethereum",
volume_24h_min: 100000,
created_after: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
sort_by: "volume_usd_24h",
limit: 20
});
// Get historical price data for a pool:
const ohlcvData = await getPoolOHLCV({
network: "ethereum",
pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
start: "-24h", // last 24 hours; works without a key
interval: "1h",
limit: 24
});
// Get historical USD price data for a token, volume-weighted across every
// pool it trades in. Requires a Dev or Pro key in DEXPAPRIKA_API_KEY and
// DEXPAPRIKA_API_BASE_URL=https://api-pro.dexpaprika.com;
// on a keyless or free key this returns 403, so fall back to getPoolOHLCV
// on the token's main pool (found with getTokenPools) instead.
const tokenOhlcvData = await getTokenOHLCV({
network: "ethereum",
token_address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
start: "-24h",
interval: "1h",
limit: 24
});
// RSI for a pool, computed server-side (no need to fetch candles first).
// Send only the parameters of the indicator you ask for: period for rsi, ema,
// bbands and vwap; fast_period, slow_period and signal_period for macd;
// std_dev for bbands. Any other parameter is refused with 400.
const rsi = await getPoolIndicator({
network: "ethereum",
pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
indicator: "rsi",
interval: "1h",
start: "-24h"
});
// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
network: "ethereum",
tokens: [
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"0xdac17f958d2ee523a2206206994597c13d831ec7"
]
});
Sample Prompts for Claude
"Analyze the JUP token on Solana. Fetch price, volume, and top liquidity pools."
"Compare trading volume between Uniswap V3 and SushiSwap on Ethereum."
"Get hourly OHLCV for the last day for SOL/USDC on Raydium and plot a price chart."
"Find the top 5 pools by liquidity on Fantom network and analyze their fee structures."
"Get recent transactions for the ETH/USDT pool on Uniswap and analyze buy vs sell pressure."
"Show me the top 10 pools on Ethereum by 24h volume."
"Search for all pools containing the ARB token and rank them by volume."
"Filter Ethereum pools with >$100K 24h volume created in the last week."
"First get all available networks, then show me the top pools on each major network."
Rate Limits & Performance
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 500 requests per minute, and there is a $30 Dev plan at 120. 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
Paging search results needs a key: on getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens and getTopTokens, the first page works keyless, but passing cursor to fetch a later page requires an API key. A free key pages without limit.
Data delay: up to 60 seconds on the free tier, real-time on the paid plans
Response Time: 100-500ms for most endpoints (network dependent)
Error Handling: Structured errors with codes, suggestions, and retry guidance
OHLCV Data Availability: Historical data typically available from token/pool creation date
Troubleshooting
Common Issues:
Rate limiting: If receiving DP429_RATE_LIMIT errors, implement exponential backoff
Missing data: Some newer tokens/pools may have incomplete historical data
Timeout errors: Large data requests may take longer, consider pagination
Network errors: Check network connectivity, the service requires internet access
OHLCV limitations: One request returns up to 1000 candles (limit); for a longer span, move start forward and ask again. Without a key OHLCV covers the last 24 hours at 1h and longer (start: "-24h"); a free key opens 7 days at 10m and longer. See OHLCV limits by plan
Empty OHLCV: Pool may be too new. Use getPoolTransactions instead
Development
# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp
# Install dependencies
npm install
# Run with auto-restart on code changes
npm run watch
# Build for production
npm run build
# Run tests
npm test
Changelog
See CHANGELOG.md for detailed release notes and migration guides.
License
This project is licensed under the MIT License - see the LICENSE file for details.