Skip to main content
Glama
DexPaprika (CoinPaprika)

DexPaprika (CoinPaprika)

Official

DexPaprika MCP Server: Real-Time DEX and Crypto Data for AI Agents

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

# 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.

Related MCP server: The Graph Token API MCP

Latest release

See CHANGELOG.md for release notes and migration guides.

What Can You Build?

  • Token Analysis Tools: Track price movements, liquidity depth changes, and volume patterns

  • DEX Comparisons: Analyze fee structures, volume, and available pools across different DEXes

  • Liquidity Pool Analytics: Monitor TVL changes, impermanent loss calculations, and price impact assessments

  • Market Analysis: Cross-chain token comparisons, volume trends, and trading activity metrics

  • 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:

DexPaprika MCP Tutorial

Claude Desktop Integration

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"]
    }
  }
}

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.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

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.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

Available Tools (20)

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.

getNetworks

List every supported blockchain network (36)

getStats

High-level ecosystem stats (total networks, DEXes, pools, tokens)

search

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

  • New pools and tokens in search: without a Dev plan or higher, getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens and filterNetworkTokens leave out pools and tokens created in the last hour, so a created_after window shorter than an hour, or the pools of a token launched in the last hour, come back empty. getPoolDetails and getTokenDetails answer at any age. Dev, Pro and Enterprise keys on api-pro.dexpaprika.com see them as they're indexed. Details: https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness

  • 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.

Additional Resources

Available Tools

20 tools
filterNetworkTokensA
Read-onlyIdempotent

Get tokens on one network matching numeric thresholds, returned under 'results' with has_next_page and next_cursor. Read-only. The first page works without an API key; paging with cursor needs a key (a free key pages without limit). Choose this over getTopTokens when the user gives numeric constraints or a time window. Use for 'tokens with FDV over $10M on Base', 'newly created tokens today', or 'low-liquidity high-volume tokens'. Without a Dev plan or higher (a Dev, Pro or Enterprise key on api-pro.dexpaprika.com), tokens created in the last hour are left out, so a created_after window shorter than an hour comes back empty. Optional filters (AND-combined): volume_24h_min/max, liquidity_usd_min/max, fdv_min/max, txns_24h_min, price_change_percentage_24h_min/max, created_after/created_before (a relative offset such as '-24h', Unix seconds, RFC3339 or YYYY-MM-DD). Also network (required); limit (default 50, max 100); cursor to page; sort_by (default 'volume_usd_24h', alias order_by); sort_dir asc/desc (default 'desc', alias sort).

Inputs: network (required), rationale (required), sort, limit, +15 more. Returns: query, results, next_cursor, has_next_page

getCapabilitiesA
Read-onlyIdempotent

Get the static agent onboarding guide for this server: supported workflows, network name synonyms (mapping words like 'eth' to the canonical slug 'ethereum'), recommended call sequences, and common pitfalls. Read-only and keyless. Read it once at the start of a session before your first query, or when asked 'how do I use this API?', 'what order should I call things in?', or 'which slug maps to eth?'. This returns onboarding docs, not live market data; for the actual list of network slugs use getNetworks, and for coverage totals use getStats. Takes no parameters beyond a short rationale.

Inputs: rationale (required). Returns: stats, server, workflows, agent_skills, +3 more

getDexPoolsA
Read-onlyIdempotent

Get the pools belonging to one specific DEX on one network, e.g. all Uniswap v3 pools on ethereum. Proxies /networks/{network}/pools/search with a dex_name filter (the old /networks/{network}/dexes/{dex}/pools endpoint was removed): rows come back under 'results' with cursor pagination (has_next_page + next_cursor), and the 24h volume field is volume_usd_24h. Read-only. The first page works without an API key; paging with cursor needs a key (a free key pages without limit). Narrower than getNetworkPools (a single exchange, not the whole chain). Use for 'show me Raydium pools', 'top pairs on PancakeSwap', or 'liquidity on Orca'. Get the dex id from getNetworkDexes or search first, and pass that response's dex_id field ('uniswap_v3'), matched case-insensitively. Do not pass its dex_name field ('Uniswap V3'): a human display name returns HTTP 200 with an empty results[] rather than an error, so an empty answer here usually means the wrong form of the name was sent. Params: network (required slug); dex (required id, e.g. 'uniswap_v3'; the REST API calls this query parameter dex_name); limit (default 10, max 100); cursor (pass previous next_cursor to page); sort_by (default 'volume_usd_24h', canonical *_24h fields, short legacy names still accepted, alias order_by); sort_dir 'asc'/'desc' (default 'desc', alias sort). The old page number is gone: page 2 and above return an error pointing at cursor.

Inputs: dex (required), network (required), rationale (required), page, +6 more. Returns: query, results, next_cursor, has_next_page

getKeyStatusA
Read-onlyIdempotent

Report whether this server is sending an API key and which plan the API sees. Use when calls are being rate limited or refused, or when the user asks whether their DexPaprika key is working. Takes no arguments and reads no market data.

Inputs: no named parameters.

getNetworkDexesA
Read-onlyIdempotent

List the DEXes (exchanges) operating on one network, such as Uniswap on ethereum or Raydium on solana, returned under 'dexes' with page_info (page, total_pages). Read-only and keyless. Use for 'which DEXes are on Base?', 'does Solana have Orca?', or to get a dex id to feed into getDexPools. Scope is a single network; call getNetworks first for the slug. Params: network (required slug); limit (default 10, max 100); page (default 1, 1-indexed); sort_by (only 'pool'; legacy alias order_by); sort_dir 'asc' or 'desc' (default 'desc'; legacy alias sort).

Inputs: network (required), rationale (required), page, sort, +4 more. Returns: dexes, page_info

getNetworkPoolsA
Read-onlyIdempotent

Get the top liquidity pools across a whole network, ranked by 24h volume by default, returned under 'results' with has_next_page and next_cursor. Read-only. The first page works without an API key; paging with cursor needs a key (a free key pages without limit). This is the primary chain-wide pool discovery tool. Use for 'biggest pools on ethereum', 'top trading pairs on Base', or 'most active pools on Solana'. Narrow to one exchange with getDexPools, or apply numeric/time filters with getNetworkPoolsFilter. Params: network (required slug); limit (default 10, max 100); cursor (pass previous next_cursor to page); sort_by (default 'volume_usd_24h', canonical *_24h fields, alias order_by); sort_dir 'asc' or 'desc' (default 'desc', alias sort).

Inputs: network (required), rationale (required), sort, limit, +4 more. Returns: query, results, next_cursor, has_next_page

getNetworkPoolsFilterA
Read-onlyIdempotent

Get pools on one network filtered by numeric thresholds, returned under 'results' with has_next_page and next_cursor. Read-only. The first page works without an API key; paging with cursor needs a key (a free key pages without limit). Choose this over getNetworkPools when the user gives numeric constraints or a time window. Use for 'pools over $1M liquidity on Base', 'pools created in the last 24h', or 'high-volume low-liquidity pairs'. Without a Dev plan or higher (a Dev, Pro or Enterprise key on api-pro.dexpaprika.com), pools created in the last hour are left out, so a created_after window shorter than an hour comes back empty. Optional filters (AND-combined): volume_24h_min/max, volume_7d_min/max, liquidity_usd_min/max, txns_24h_min, created_after/created_before (a relative offset such as '-24h', Unix seconds, RFC3339 or YYYY-MM-DD). Also network (required); limit (default 50, max 100); cursor to page; sort_by (default 'volume_usd_24h', alias order_by); sort_dir asc/desc (default 'desc', alias sort).

Inputs: network (required), rationale (required), sort, limit, +23 more. Returns: query, results, next_cursor, has_next_page

getNetworksA
Read-onlyIdempotent

List every blockchain network DexPaprika indexes, each row carrying its network id (slug), 24h volume, transaction count, and pool count. Read-only and keyless. Start here (or getCapabilities) to get the exact network slug that nearly every other tool requires as its 'network' argument. Use for 'which chains do you support?', 'is Base/Solana/Arbitrum covered?', or 'what is the slug for Polygon?'. Returns the full array with no pagination or sorting; takes no parameters beyond a short rationale. For platform-wide totals rather than a per-network list use getStats.

Inputs: rationale (required). Returns: networks

getPoolDetailsA
Read-onlyIdempotent

Get the full current snapshot for one pool by address: its two tokens, current price, liquidity/TVL, 24h volume, and transaction counts, returned as a single pool object (not a list). Read-only and keyless. Use after search or getNetworkPools surfaces a pool, or for 'price/TVL of this pool?' or 'details for pool 0x...'. Returns live values only; for historical candles use getPoolOHLCV, and for the raw swap feed use getPoolTransactions. Params: network (required slug); pool_address (required, e.g. '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640'); inversed (optional bool, default false, flips the token price ratio to token1/token0).

Inputs: network (required), rationale (required), pool_address (required), inversed. Returns: id, fee, chain, dex_id, +10 more

getPoolIndicatorA
Read-onlyIdempotent

Get a technical indicator (RSI, EMA, MACD, Bollinger Bands or VWAP) for one pool, computed server-side from the pool's completed OHLCV candles and returned as a time series. Read-only. Use for 'is this pool overbought?', 'RSI of this pair', 'MACD cross on the last candle', or as a ready-made signal input for a trading or screening agent, instead of fetching getPoolOHLCV and computing the indicator yourself. The indicator follows the pool's price as getPoolOHLCV reports it, with no inversed parameter. History depth and interval follow the same plan limits as getPoolOHLCV; asking for more returns 403 with a message naming the plan that allows it. Values come oldest first, one per completed candle: rsi, ema and vwap return value; macd returns macd, signal and histogram; bbands returns upper, middle and lower. RSI over 70 is commonly read as overbought and under 30 as oversold; a MACD histogram that changes sign means MACD crossed its signal line. RSI, EMA and MACD are smoothed, so start at least ten periods before the first value you rely on. Params: network (required); pool_address (required); indicator (required): 'rsi', 'ema', 'macd', 'bbands' or 'vwap'; interval (pass it every time: '1m','5m','10m','15m','30m','1h','6h','12h','24h' or '1d'); start (optional; a relative offset such as '-24h' or '-7d', Unix seconds, RFC3339 or yyyy-mm-dd; without it you get the last limit values); end (optional, exclusive); limit (default 100, max 1000); cursor (next_cursor of the previous page, not with start); period for rsi (default 14), ema (20), bbands (20) and vwap (14); fast_period (12), slow_period (26) and signal_period (9) for macd only; std_dev (2) for bbands only. A parameter that belongs to another indicator is refused.

Inputs: network (required), indicator (required), rationale (required), pool_address (required), +10 more. Returns: data, network, interval, indicator, +5 more

getPoolOHLCVA
Read-onlyIdempotent

Get historical OHLCV candles (open, high, low, close, volume) for one pool over a time range, returned as a time-series array. Read-only and keyless. Use for 'price history of this pair', 'hourly chart for the last day', or backtesting; for the single current price use getPoolDetails instead. Params: network (required); pool_address (required); start (required; easiest as a relative offset from now such as '-24h', so you need not know today's date; also Unix seconds, RFC3339 or yyyy-mm-dd); end (optional); interval one of '1m','5m','10m','15m','30m','1h','6h','12h','24h' (default '24h'); limit (default 100, max 1000 candles); inversed (optional bool, default false). History depth and interval depend on the plan: without a key, the last 24 hours at '1h' and longer; a free key (DEXPAPRIKA_API_KEY) opens 7 days at '10m' and longer. Asking for more returns 403 with a message naming the plan that allows it.

Inputs: start (required), network (required), rationale (required), pool_address (required), +4 more. Returns: ohlcv

getPoolTransactionsA
Read-onlyIdempotent

Get one pool's recent individual swap transactions, newest first, returned under 'transactions' (paginate with page, or a cursor). Read-only. Requires a Dev, Pro or Enterprise key since 30 September 2026: set DEXPAPRIKA_API_KEY to it and DEXPAPRIKA_API_BASE_URL to https://api-pro.dexpaprika.com. Keyless and free keys get 403 (DP403_PLAN_REQUIRED); getPoolDetails still gives the pool's 24h transaction counts and volume. These are per-trade records, not aggregated candles (use getPoolOHLCV) or a summary snapshot (use getPoolDetails). Use for 'recent trades on this pool', 'who swapped in the last hour', or 'raw transaction feed'. Params: network (required); pool_address (required); limit (default 10, max 100); page (default 1, up to 100 pages) or cursor (a transaction id); from (optional, inclusive: a relative offset such as '-1h', Unix seconds, RFC3339 or YYYY-MM-DD; capped to the last 7 days); to (optional, exclusive, same formats, must be after from).

Inputs: network (required), rationale (required), pool_address (required), to, +4 more. Returns: page_info, transactions

getStatsA
Read-onlyIdempotent

Get platform-wide totals for DexPaprika: the number of networks, DEXes, pools, and tokens indexed, returned as a single summary object. Read-only and keyless. Use for 'how much data do you cover?', 'how many chains or pools total?', or a one-line coverage summary. These are ecosystem-wide counts, not per-network figures; use getNetworks for the per-chain breakdown, or getCapabilities for onboarding docs. Takes no parameters beyond a short rationale.

Inputs: rationale (required). Returns: pools, chains, tokens, factories

getTokenDetailsA
Read-onlyIdempotent

Get one token's data and metadata by contract address on one network: multi-timeframe price and volume metrics, plus name, website, Twitter, and Telegram links, returned as a single token object. Read-only and keyless. Use for 'price and volume for 0x... on Base' or 'tell me about this token'. If you only have a symbol like WETH, call search first to resolve the address and network. For many tokens' prices at once use getTokenMultiPrices; for the pools holding this token use getTokenPools. Params: network (required slug); token_address (required contract address, e.g. 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN' on solana).

Inputs: network (required), rationale (required), token_address (required). Returns: id, name, chain, symbol, +8 more

getTokenIndicatorA
Read-onlyIdempotent

Get a technical indicator (RSI, EMA, MACD, Bollinger Bands or VWAP) for one token, computed server-side from its USD candles across every pool it trades in on the network (the series getTokenOHLCV returns), as a time series. Requires a Dev, Pro or Enterprise plan: set DEXPAPRIKA_API_KEY to that key and DEXPAPRIKA_API_BASE_URL to https://api-pro.dexpaprika.com. On a keyless or free key this returns 403 (DP403_PLAN_REQUIRED); then use getPoolIndicator on the token's main pool, found with getTokenPools sorted by volume. Use for 'RSI of this token' or a token-level signal for an agent; for one pair use getPoolIndicator. Values come oldest first, one per completed candle: rsi, ema and vwap return value; macd returns macd, signal and histogram; bbands returns upper, middle and lower. RSI over 70 is commonly read as overbought and under 30 as oversold; a MACD histogram that changes sign means MACD crossed its signal line. RSI, EMA and MACD are smoothed, so start at least ten periods before the first value you rely on. Params: network (required); token_address (required); indicator (required): 'rsi', 'ema', 'macd', 'bbands' or 'vwap'; interval (pass it every time: '1m','5m','10m','15m','30m','1h','6h','12h','24h' or '1d'); start (optional; a relative offset such as '-24h' or '-7d', Unix seconds, RFC3339 or yyyy-mm-dd; without it you get the last limit values); end (optional, exclusive); limit (default 100, max 1000); cursor (next_cursor of the previous page, not with start); period for rsi (default 14), ema (20), bbands (20) and vwap (14); fast_period (12), slow_period (26) and signal_period (9) for macd only; std_dev (2) for bbands only. A parameter that belongs to another indicator is refused.

Inputs: network (required), indicator (required), rationale (required), token_address (required), +10 more. Returns: data, network, interval, indicator, +5 more

getTokenMultiPricesA
Read-onlyIdempotent

Get current USD prices for up to 10 tokens on the same network in one batched call, returned as a prices array plus a missing_tokens list. Read-only and keyless. Tokens that cannot be priced come back in missing_tokens rather than being dropped, so check that list for partial failures. Use for 'prices for these tokens', 'compare the price of X, Y and Z', or building a portfolio/dashboard snapshot. For one token with full metadata and multi-timeframe stats use getTokenDetails. Params: network (required slug, all tokens must share it); tokens (required array of 1 to 10 contract addresses).

Inputs: tokens (required), network (required), rationale (required). Returns: prices, missing_tokens

getTokenOHLCVA
Read-onlyIdempotent

Get historical USD OHLCV candles for one token over a time range, returned as a time-series array. The price and volume are computed across every pool the token trades in on the network (a volume-weighted price, and volume summed across those pools), not a single pair. Requires a Dev or Pro plan: set DEXPAPRIKA_API_KEY to that key and DEXPAPRIKA_API_BASE_URL to https://api-pro.dexpaprika.com. On a keyless or free key this returns 403 (DP403_PLAN_REQUIRED), since there is no keyless or free window at all. On that 403, fall back to getPoolOHLCV on the token's main pool, found with getTokenPools sorted by volume. Use for 'price history of this token' or 'USD chart for this token'; for a single pair's candles use getPoolOHLCV, and for the current price use getTokenDetails. Params: network (required); token_address (required); start (required; easiest as a relative offset from now such as '-24h', so you need not know today's date; also Unix seconds, RFC3339 or yyyy-mm-dd); end (optional, same formats); interval one of '1m','5m','10m','15m','30m','1h','6h','12h','24h' (default '24h'); limit (default 10, max 1000 candles). Dev plan history is limited to the last 30 days. There is no inversed parameter on this endpoint.

Inputs: start (required), network (required), rationale (required), token_address (required), +3 more. Returns: ohlcv

getTokenPoolsA
Read-onlyIdempotent

Get the liquidity pools that contain a specific token on one network, returned under 'results' with has_next_page and next_cursor. Read-only. The first page works without an API key; paging with cursor needs a key (a free key pages without limit). Use for 'which pools hold WETH on ethereum?' or 'liquidity venues for 0x...'. Network-scoped, so run search first if unsure of the network; unknown addresses return empty results, not an error. Without a Dev plan or higher (a Dev, Pro or Enterprise key on api-pro.dexpaprika.com), pools created in the last hour are left out, so a token launched in the last hour shows no pools yet. For the token's own price use getTokenDetails. Params: network (required); token_address (required); limit (default 10, max 100); cursor to page; sort_by (default 'volume_usd_24h', alias order_by); sort_dir asc/desc (default 'desc', alias sort). Extra params such as inversed or paired_token_address are unsupported and error.

Inputs: network (required), rationale (required), token_address (required), sort, +9 more. Returns: query, results, next_cursor, has_next_page

getTopTokensA
Read-onlyIdempotent

Get the top tokens on one network ranked by volume, liquidity, transactions, FDV, or 24h price change, returned under 'results' with has_next_page and next_cursor. Read-only. The first page works without an API key; paging with cursor needs a key (a free key pages without limit). Use for 'top gainers on Solana', 'highest-volume tokens on Base', or 'biggest tokens by FDV on ethereum'. For arbitrary numeric filters or a time window use filterNetworkTokens instead. Params: network (required slug); limit (default 50, max 100); cursor (pass previous next_cursor to page); sort_by (default 'volume_usd_24h', alias order_by), noting that ranking by raw price is unsupported and silently falls back to volume; sort_dir asc/desc (default 'desc', alias sort).

Inputs: network (required), rationale (required), sort, limit, +4 more. Returns: query, results, next_cursor, has_next_page

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 20 tools

    Disambiguation4/5

    Most tools have crisply distinct resource+action targets, and the descriptions explicitly cross-reference siblings ('choose this over getNetworkPools when...', 'for one token use getTokenDetails'). The one soft spot is the cluster of chain-wide listing tools (getNetworkPools, getNetworkPoolsFilter, getTopTokens, filterNetworkTokens, getDexPools), which an agent could plausibly confuse despite the guidance text. Overall the boundaries are well drawn, just requiring careful reading.

    Naming Consistency4/5

    Nearly all tools follow a consistent camelCase get_<resource><aspect> pattern (getTokenDetails, getPoolOHLCV, getNetworkPoolsFilter), with resource prefixes (token/pool/network/dex) aiding scanability. Minor deviations are the bare 'search' and the verb-first 'filterNetworkTokens', which break the 'get' convention slightly. Still highly predictable and readable.

    Tool Count4/5

    20 tools is at the upper edge, but each occupies a distinct cell in the token × pool × network × meta matrix (details, OHLCV, indicator, transactions, listings, meta). The token/pool OHLCV+indicator pairs are symmetric rather than redundant. It stays justifiable, though a few listing variants could arguably be folded into parameterized tools.

    Completeness4/5

    The surface covers discovery (search, getNetworks, getNetworkDexes), market data (details, multi-prices, OHLCV, indicators), transactions, and meta/onboarding (capabilities, stats, key status), with documented plan-gating and fallbacks. Gaps are minor: no single-DEX detail object, no pool/token liquidity or TVL history, and no aggregate DEX-level volume stats. Core agent workflows have no dead ends.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Official MCP server that turns The Graph’s Token API into a plug-and-play web3 data tool. Exposes ERC-20 & NFT metadata, balances, transfers, top-holder stats, prices, and more, allowing LLMs to run SQL queries on structured and indexed blockchain data.
      2
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides real-time access to cryptocurrency and DEX data across multiple blockchains, enabling users to analyze tokens, pools, trading volumes, and perform technical analysis through DexPaprika's API. No API keys required for seamless integration with AI assistants.
      11
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A comprehensive cryptocurrency market-data MCP server with 49 tools across six data sources, enabling LLMs to answer market questions via natural language.
      49
      MIT