Skip to content
Back to search

dexpaprika-mcp

DexPaprika MCP server for real-time crypto token data, DEX trading activity, and DeFi analytics across multiple blockchains.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/coinpaprika/dexpaprika-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/coinpaprika/dexpaprika-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/coinpaprika--dexpaprika-mcp/badge.svg)](/listings/coinpaprika--dexpaprika-mcp)

HTML

<a href="/listings/coinpaprika--dexpaprika-mcp"><img src="/api/listings/coinpaprika--dexpaprika-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

To install DexPaprika for Claude Desktop automatically via [Smithery](https://smithery.ai/servers/coinpaprika/dexpaprika):

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 340 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # DexPaprika MCP Server: Real-Time DEX and Crypto Data for AI Agents
  2. 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.
  3. ## TL;DR
  4. ```bash
  5. # Install globally
  6. npm install -g dexpaprika-mcp
  7. # Start the server
  8. dexpaprika-mcp
  9. # Or run directly without installation
  10. npx dexpaprika-mcp@latest
  11. ```
  12. DexPaprika 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)
  13. > **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.
  14. ## Latest release
  15. See [CHANGELOG.md](CHANGELOG.md) for release notes and migration guides.
  16. ## What Can You Build?
  17. - **Token Analysis Tools**: Track price movements, liquidity depth changes, and volume patterns
  18. - **DEX Comparisons**: Analyze fee structures, volume, and available pools across different DEXes
  19. - **Liquidity Pool Analytics**: Monitor TVL changes, impermanent loss calculations, and price impact assessments
  20. - **Market Analysis**: Cross-chain token comparisons, volume trends, and trading activity metrics
  21. - **Portfolio Trackers**: Current value tracking, historical performance analysis, yield opportunities
  22. - **Technical Analysis**: Perform advanced technical analysis using historical OHLCV data, including trend identification, pattern recognition, and indicator calculations
  23. ## Installation
  24. ### Installing via Smithery
  25. To install DexPaprika for Claude Desktop automatically via [Smithery](https://smithery.ai/servers/coinpaprika/dexpaprika):
  26. ```bash
  27. npx -y smithery mcp add coinpaprika/dexpaprika
  28. ```
  29. ### Manual Installation
  30. ```bash
  31. # Install globally (recommended for regular use)
  32. npm install -g dexpaprika-mcp
  33. # Start the server
  34. dexpaprika-mcp
  35. ```
  36. 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.
  37. ## Video Tutorial
  38. Watch our step-by-step tutorial on setting up and using the DexPaprika MCP server:
  39. [![DexPaprika MCP Tutorial](https://img.youtube.com/vi/rIxFn2PhtvI/0.jpg)](https://www.youtube.com/watch?v=rIxFn2PhtvI)
  40. ## Claude Desktop Integration
  41. Add the following to your Claude Desktop configuration file:
  42. **macOS**: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
  43. **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
  44. ```json
  45. {
  46. "mcpServers": {
  47. "dexpaprika": {
  48. "command": "npx",
  49. "args": ["dexpaprika-mcp@latest"]
  50. }
  51. }
  52. }
  53. ```
  54. After restarting Claude Desktop, the DexPaprika tools will be available to Claude automatically.
  55. ### Optional: using an API key
  56. **This works without a key and always will.** No signup, no card, nothing to
  57. configure. Everything above is the supported way to run it.
  58. A free key raises the monthly allowance and opens streaming on any token rather
  59. than the public showcase set. It does **not** raise the per-minute request
  60. limit, which is the same on both tiers. Get one at
  61. [console.dexpaprika.com](https://console.dexpaprika.com); current limits are on
  62. the [rate limits page](https://docs.dexpaprika.com/knowledge-base/rate-limits).
  63. ```json
  64. {
  65. "mcpServers": {
  66. "dexpaprika": {
  67. "command": "npx",
  68. "args": ["dexpaprika-mcp@latest"],
  69. "env": {
  70. "DEXPAPRIKA_API_KEY": "your_key_here"
  71. }
  72. }
  73. }
  74. }
  75. ```
  76. **The key goes in on its own, as the entire `Authorization` value.** Paste it
  77. exactly as issued, with nothing in front of it. Almost every other API wants
  78. something in front of the key, so this is the single most common reason a
  79. working key looks broken.
  80. Two things worth knowing:
  81. - **A key we cannot read does not produce an error.** The data endpoints ignore
  82. an unreadable key and serve you as an anonymous caller, with a normal `200` and
  83. real data, so a typo looks exactly like success. Ask the assistant to run
  84. `getKeyStatus` after setting one: it reports which plan the API actually sees
  85. and names the likely cause when the key is not landing.
  86. - **Dev and Pro customers** additionally set `DEXPAPRIKA_API_BASE_URL` to
  87. `https://api-pro.dexpaprika.com`, which is also what `getTokenOHLCV` needs. The host does not change automatically,
  88. because sending a free key to that host returns 403.
  89. ### Hosted server (no installation)
  90. If 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:
  91. | Transport | Endpoint | Use Case |
  92. |-----------|----------|----------|
  93. | Streamable HTTP | `https://mcp.dexpaprika.com/streamable-http` | Recommended for most clients |
  94. | SSE | `https://mcp.dexpaprika.com/sse` | Legacy SSE transport |
  95. | JSON-RPC | `https://mcp.dexpaprika.com/json-rpc` | Direct JSON-RPC |
  96. > **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.
  97. ```json
  98. {
  99. "mcpServers": {
  100. "dexpaprika": {
  101. "type": "streamable-http",
  102. "url": "https://mcp.dexpaprika.com/streamable-http"
  103. }
  104. }
  105. }
  106. ```
  107. ## Available Tools (20)
  108. 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`.
  109. ### Discovery
  110. | Tool | Description |
  111. |------|-------------|
  112. | `getCapabilities` | Server capabilities, workflow patterns, network synonyms, and best practices. **Start here.** |
  113. | `getNetworks` | List every supported blockchain network (36) |
  114. | `getStats` | High-level ecosystem stats (total networks, DEXes, pools, tokens) |
  115. | `search` | Search tokens, pools, and DEXes across ALL networks by name, symbol, or address |
  116. | `getKeyStatus` | Whether a key is being sent and which plan the API sees. Reads no market data. |
  117. ### DEX Operations
  118. | Tool | Description | Required Parameters |
  119. |------|-------------|---------------------|
  120. | `getNetworkDexes` | List DEXes on a specific network | `network` |
  121. ### Pool Operations
  122. | Tool | Description | Required Parameters |
  123. |------|-------------|---------------------|
  124. | `getNetworkPools` | **PRIMARY**. Get top liquidity pools on a network | `network` |
  125. | `getDexPools` | Get pools from a specific DEX (rows under `results`, cursor pagination; paging past the first page needs a key) | `network`, `dex` |
  126. | `getNetworkPoolsFilter` | Filter pools by volume, transactions, creation time | `network` |
  127. | `getPoolDetails` | Detailed pool info (price, volume, TVL, tokens) | `network`, `pool_address` |
  128. | `getPoolOHLCV` | Historical OHLCV candle data | `network`, `pool_address`, `start` |
  129. | `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` |
  130. | `getPoolTransactions` | Recent transactions/trades for a pool | `network`, `pool_address` |
  131. ### Token Operations
  132. | Tool | Description | Required Parameters |
  133. |------|-------------|---------------------|
  134. | `getTokenDetails` | Detailed token information | `network`, `token_address` |
  135. | `getTokenPools` | Liquidity pools containing a token (network-scoped filter, `results` + cursor pagination; paging past the first page needs a key) | `network`, `token_address` |
  136. | `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` |
  137. | `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` |
  138. | `getTokenMultiPrices` | Batched prices for up to 10 tokens | `network`, `tokens[]` |
  139. | `getTopTokens` | Top tokens on a network ranked by volume, liquidity, FDV, or 24h price change | `network` |
  140. | `filterNetworkTokens` | Filter tokens by volume, liquidity, FDV, transactions, and creation time | `network` |
  141. ### Example Usage
  142. ```javascript
  143. // Start by getting capabilities for workflow guidance:
  144. const caps = await getCapabilities();
  145. // Get details about a specific token:
  146. const solanaJupToken = await getTokenDetails({
  147. network: "solana",
  148. token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
  149. });
  150. // Find pools containing a token (returns `results` with cursor pagination;
  151. // the token filter only works network-scoped). This first page works without
  152. // a key; passing the response's next_cursor back as cursor to fetch a later
  153. // page needs an API key (a free key pages without limit):
  154. const jupiterPools = await getTokenPools({
  155. network: "solana",
  156. token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  157. order_by: "volume_usd_24h",
  158. limit: 5
  159. });
  160. // Get top pools on Ethereum (first page, returns `results` with cursor pagination):
  161. const ethereumPools = await getNetworkPools({
  162. network: "ethereum",
  163. order_by: "volume_usd_24h",
  164. limit: 10
  165. });
  166. // Filter pools by volume and creation time:
  167. const filteredPools = await getNetworkPoolsFilter({
  168. network: "ethereum",
  169. volume_24h_min: 100000,
  170. created_after: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  171. sort_by: "volume_usd_24h",
  172. limit: 20
  173. });
  174. // Get historical price data for a pool:
  175. const ohlcvData = await getPoolOHLCV({
  176. network: "ethereum",
  177. pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  178. start: "-24h", // last 24 hours; works without a key
  179. interval: "1h",
  180. limit: 24
  181. });
  182. // Get historical USD price data for a token, volume-weighted across every
  183. // pool it trades in. Requires a Dev or Pro key in DEXPAPRIKA_API_KEY and
  184. // DEXPAPRIKA_API_BASE_URL=https://api-pro.dexpaprika.com;
  185. // on a keyless or free key this returns 403, so fall back to getPoolOHLCV
  186. // on the token's main pool (found with getTokenPools) instead.
  187. const tokenOhlcvData = await getTokenOHLCV({
  188. network: "ethereum",
  189. token_address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  190. start: "-24h",
  191. interval: "1h",
  192. limit: 24
  193. });
  194. // RSI for a pool, computed server-side (no need to fetch candles first).
  195. // Send only the parameters of the indicator you ask for: period for rsi, ema,
  196. // bbands and vwap; fast_period, slow_period and signal_period for macd;
  197. // std_dev for bbands. Any other parameter is refused with 400.
  198. const rsi = await getPoolIndicator({
  199. network: "ethereum",
  200. pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  201. indicator: "rsi",
  202. interval: "1h",
  203. start: "-24h"
  204. });
  205. // Batch prices for multiple tokens (max 10):
  206. const prices = await getTokenMultiPrices({
  207. network: "ethereum",
  208. tokens: [
  209. "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  210. "0xdac17f958d2ee523a2206206994597c13d831ec7"
  211. ]
  212. });
  213. ```
  214. ## Sample Prompts for Claude
  215. - "Analyze the JUP token on Solana. Fetch price, volume, and top liquidity pools."
  216. - "Compare trading volume between Uniswap V3 and SushiSwap on Ethereum."
  217. - "Get hourly OHLCV for the last day for SOL/USDC on Raydium and plot a price chart."
  218. - "Find the top 5 pools by liquidity on Fantom network and analyze their fee structures."
  219. - "Get recent transactions for the ETH/USDT pool on Uniswap and analyze buy vs sell pressure."
  220. - "Show me the top 10 pools on Ethereum by 24h volume."
  221. - "Search for all pools containing the ARB token and rank them by volume."
  222. - "Filter Ethereum pools with >$100K 24h volume created in the last week."
  223. - "First get all available networks, then show me the top pools on each major network."
  224. ## Rate Limits & Performance
  225. - **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
  226. - **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.
  227. - **Data delay**: up to 60 seconds on the free tier, real-time on the paid plans
  228. - **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
  229. - **Response Time**: 100-500ms for most endpoints (network dependent)
  230. - **Error Handling**: Structured errors with codes, suggestions, and retry guidance
  231. - **OHLCV Data Availability**: Historical data typically available from token/pool creation date
  232. ## Troubleshooting
  233. **Common Issues:**
  234. - **Rate limiting**: If receiving `DP429_RATE_LIMIT` errors, implement exponential backoff
  235. - **Missing data**: Some newer tokens/pools may have incomplete historical data
  236. - **Timeout errors**: Large data requests may take longer, consider pagination
  237. - **Network errors**: Check network connectivity, the service requires internet access
  238. - **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](https://docs.dexpaprika.com/knowledge-base/rate-limits#ohlcv-limits-by-plan)
  239. - **Empty OHLCV**: Pool may be too new. Use `getPoolTransactions` instead
  240. ## Development
  241. ```bash
  242. # Clone the repository
  243. git clone https://github.com/coinpaprika/dexpaprika-mcp.git
  244. cd dexpaprika-mcp
  245. # Install dependencies
  246. npm install
  247. # Run with auto-restart on code changes
  248. npm run watch
  249. # Build for production
  250. npm run build
  251. # Run tests
  252. npm test
  253. ```
  254. ## Changelog
  255. See [CHANGELOG.md](CHANGELOG.md) for detailed release notes and migration guides.
  256. ## License
  257. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  258. ## Additional Resources
  259. - [DexPaprika API Documentation](https://docs.dexpaprika.com/introduction)
  260. - [Hosted MCP Server](https://mcp.dexpaprika.com), zero-setup option
  261. - [Model Context Protocol Specification](https://modelcontextprotocol.io)
  262. - [DexPaprika](https://dexpaprika.com) - Comprehensive onchain analytics market data
  263. - [CoinPaprika](https://coinpaprika.com) - Comprehensive cryptocurrency market data

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.