> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dexpaprika.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DexPaprika MCP server: DEX data for Claude, Cursor & AI agents

> Give AI assistants live DEX data via MCP: pools, tokens and prices on 36 chains. Free to start, no API key. Install locally with npx or use the hosted server.

## Integration overview

Install and configure the DexPaprika MCP server so AI tools can query networks, DEXes, pools, tokens, and search.

## What is MCP?

MCP (Model Context Protocol) is an [open protocol standard created by Anthropic](https://modelcontextprotocol.io/introduction) that gives AI models a unified way to connect to external data sources and tools. The DexPaprika MCP server leverages this protocol to provide AI assistants like Claude with access to real-time crypto and DeFi market data, enabling advanced conversations about blockchain networks, decentralized exchanges (DEXes), liquidity pools, and tokens across the DeFi ecosystem.

<Note>
  **Looking for an easier setup?** If you prefer not to install anything locally, check out our [DexPaprika Hosted MCP Server](/ai-integration/hosted-mcp-server) for instant access with zero installation required.
</Note>

## Installation guide

<iframe width="560" height="315" src="https://www.youtube.com/embed/rIxFn2PhtvI?si=c1BZ5bfS6chC7p-a" title="DexPaprika MCP Server Installation Guide" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

### Prerequisites

Before installing the DexPaprika MCP server, ensure you have:

* [Node.js](https://nodejs.org/) (v16 or higher) installed on your system
* [npm](https://www.npmjs.com/) (comes with Node.js) or [yarn](https://yarnpkg.com/) package manager
* [Claude Desktop](https://claude.ai/desktop) or [Cursor](https://cursor.sh/) installed if you want to use the MCP server with these applications

### Installation options

#### Option 1: Global installation (recommended)

Installing the DexPaprika MCP server globally makes it available throughout your system:

```bash theme={null}
npm install -g dexpaprika-mcp
```

After installation, you can start the server by running:

```bash theme={null}
dexpaprika-mcp
```

#### Option 2: Use with npx (no installation)

Alternatively, you can run the server directly without installation using npx:

```bash theme={null}
npx dexpaprika-mcp@latest
```

This is useful for trying out the server without permanently installing it.

### Verification

To verify that your installation was successful, run:

```bash theme={null}
dexpaprika-mcp --version
```

You should see the current version number of the DexPaprika MCP server.

## Configuration

### Claude Desktop configuration

To use the DexPaprika MCP server with Claude Desktop:

1. Download and install [Claude Desktop](https://claude.ai/desktop) if you haven't already

2. Locate your Claude Desktop configuration file:
   * **macOS**: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
   * **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

3. If the file doesn't exist, create it with the following content:

```json theme={null}
{
  "mcpServers": {
    "dexpaprika": {
      "command": "dexpaprika-mcp"
    }
  }
}
```

4. If the file already exists, add the DexPaprika configuration to the existing `mcpServers` object:

```json theme={null}
"dexpaprika": {
  "command": "dexpaprika-mcp"
}
```

5. Save the file and restart Claude Desktop.

6. To verify the configuration, open Claude Desktop and try asking a question about cryptocurrency data, such as "What are the top liquidity pools on Ethereum?"

<Note>Make sure you have the latest version of our package by running `npm update -g dexpaprika-mcp`</Note>

### Cursor configuration

If you're using Cursor IDE with Claude:

1. Download and install [Cursor](https://cursor.sh/) if you haven't already
2. Open Cursor and click on the Claude button in the sidebar
3. Click the settings (gear) icon and select "Add MCP Server"
4. Fill in the following information:
   * **Server name**: `dexpaprika`
   * **Type**: `command` (select from dropdown)
   * **Command to run**: `npx dexpaprika-mcp@latest`
5. Click "Add" to save the configuration
6. Alternatively, Cursor will automatically use any MCP servers configured in Claude Desktop

## Troubleshooting

If you encounter issues with the DexPaprika MCP server:

1. **Server not found errors**:
   * Ensure the server is installed correctly using `npm list -g dexpaprika-mcp`
   * Try reinstalling with `npm install -g dexpaprika-mcp`

2. **Connection errors**:
   * Check that your internet connection is active
   * Verify that no firewall is blocking the connection

3. **Configuration errors**:
   * Double-check your configuration file syntax
   * Ensure the path to the configuration file is correct for your OS

4. **Command not found errors**:
   * Ensure Node.js is installed and in your PATH
   * Try using the full path to the npm or npx executables

## Features

The DexPaprika MCP server provides access to:

* Blockchain network information across multiple chains
* Decentralized exchange (DEX) data
* Liquidity pool details and metrics
* Token information and market data
* Price and volume analytics for tokens and pools
* Comprehensive search capabilities across DeFi entities

## Available tools

<Info>
  New to the server? Call **getCapabilities** first. In one call it returns the full tool list, network name synonyms, recommended call sequences, and common pitfalls, so an agent can self-onboard before making any data calls.
</Info>

The DexPaprika MCP server exposes 17 tools.

**Discovery and onboarding**

* **getCapabilities** - Agent onboarding: supported workflows, network synonyms, pitfalls, and recommended call sequences. Call this first.
* **getNetworks** - List every supported blockchain network with 24h volume and indexing stats
* **getStats** - Platform-wide totals: networks, DEXes, pools, and tokens indexed
* **search** - Search across all networks for tokens, pools, and DEXes by name, symbol, or address

**Pools**

* **getNetworkPools** - Top liquidity pools on a network, ranked by 24h volume by default
* **getNetworkPoolsFilter** - Filter pools on a network by volume, liquidity, transactions, or creation time
* **getDexPools** - Pools on a specific DEX within a network (backed by pool search with a `dex_name` filter, since the old DEX pools endpoint returns `410 Gone`)
* **getPoolDetails** - Full details for one pool: tokens, price, liquidity, and 24h volume
* **getPoolOHLCV** - Historical OHLCV (candlestick) data for a pool (1m to 24h intervals)
* **getPoolTransactions** - Recent swaps for a pool (`from`/`to` are UNIX timestamps, capped to the last 7 days)

**Tokens**

* **getTokenDetails** - Metadata and multi-timeframe price and volume metrics for one token
* **getTokenPools** - Liquidity pools containing a specific token on a network
* **getTokenMultiPrices** - USD prices for up to 10 tokens in one batched call
* **filterNetworkTokens** - Filter tokens on a network by volume, liquidity, FDV, transactions, or creation time
* **getTopTokens** - Top tokens on a network ranked by volume, liquidity, transactions, FDV, or 24h change

**DEXes**

* **getNetworkDexes** - DEXes operating on a specific network

**Feedback** (hosted server only)

* **submitFeedback** - Report a problem, unexpected response, or missing data back to the DexPaprika team

<Note>
  **Agent notes:** every read tool takes a required `rationale` string (1-2 sentences on what triggered the call). The pool and token list tools (`getNetworkPools`, `getNetworkPoolsFilter`, `getDexPools`, `getTokenPools`, `getTopTokens`, `filterNetworkTokens`) return rows under `results` with cursor pagination (`has_next_page` + `next_cursor`), and sort with canonical `sort_by` / `sort_dir`.
</Note>

For full parameters, defaults, and return shapes for every tool, see the [MCP tools reference](/ai-integration/mcp-tools).

## Usage examples

Once configured, you can ask Claude questions about DeFi data. Here are some example prompts:

### General market data

* "What are the top 5 liquidity pools across all networks by volume?"

### Network-specific queries

* "Which blockchain networks are supported by DexPaprika?"
* "What are the top DEXes on the Solana network?"
* "Show me the top 10 liquidity pools on Ethereum, ordered by volume."

### DEX and pool analysis

* "What are the most active pools on Uniswap V3?"
* "Show me details about the USDC/ETH pool on Uniswap V3."
* "Compare the trading volume between PancakeSwap and Uniswap."

### Token information

* "What's the current price of SOL in the Raydium pool on Solana?"
* "Find all pools that include the SHIB token."

### Search functionality

* "Search for pools related to 'Bitcoin'"
* "Find tokens with 'Pepe' in their name"

## Advanced queries

You can also ask Claude to perform more complex analysis:

* "Compare the liquidity and volume of the top 3 DEXes on Ethereum"
* "What's the price difference of ETH between Uniswap and SushiSwap?"
* "Show me the tokens with the highest price volatility in the last 24 hours"
* "Analyze the trading volume trends for BNB on PancakeSwap"

## Support

If you need further assistance, you can:

* Contact DexPaprika support by [email](mailto:support@coinpaprika.com)
* Join the [Discord community](https://discord.gg/DhJge5TUGM)

### FAQs

<AccordionGroup>
  <Accordion title="Do I need an API key for the MCP server?">
    No. The underlying DexPaprika API is public; the MCP server proxies public endpoints.
  </Accordion>

  <Accordion title="Claude vs Cursor setup differences?">
    Claude Desktop reads `claude_desktop_config.json`; Cursor can add the same server via “Add MCP Server” or inherit Claude’s config.
  </Accordion>

  <Accordion title="How to troubleshoot 'Server disconnected'?">
    Use absolute paths to `uvx`/`npx` in the config; many desktop apps don’t inherit shell `PATH`.
  </Accordion>

  <Accordion title="Is the MCP server read-only?">
    Yes. Every tool is a read-only data query; the server cannot modify on-chain state or your data, so no flag is needed.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {JSON.stringify({
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [
        {"@type": "Question","name": "Do I need an API key for the MCP server?","acceptedAnswer": {"@type": "Answer","text": "No. The API is public; the MCP server proxies public endpoints."}},
        {"@type": "Question","name": "Claude vs Cursor setup differences?","acceptedAnswer": {"@type": "Answer","text": "Claude uses claude_desktop_config.json; Cursor can add or inherit that server."}},
        {"@type": "Question","name": "How to troubleshoot 'Server disconnected'?","acceptedAnswer": {"@type": "Answer","text": "Use absolute paths to uvx/npx because desktop apps may not inherit PATH."}},
        {"@type": "Question","name": "Is the MCP server read-only?","acceptedAnswer": {"@type": "Answer","text": "Yes. Every tool is a read-only data query; the server cannot modify on-chain state or your data."}}
      ]
    })}
</script>