> ## 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. Install locally with npx or use the hosted server. Zero setup.

## 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 on the settings 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

The DexPaprika MCP server provides the following tools to Claude:

1. **getNetworks** - Retrieve a list of every supported blockchain network and its metadata
2. **getNetworkDexes** - Get a list of available decentralized exchanges on a specific network
3. **getNetworkPools** - Get top liquidity pools on a specific network, sorted by volume, price, transactions, or creation date
4. **getDexPools** - Get top pools on a specific DEX within a network
5. **getPoolDetails** - Get detailed information about a specific pool including liquidity, reserves, and pricing
6. **getPoolOHLCV** - Get historical OHLCV (candlestick) data for a pool with configurable intervals (1m to 24h)
7. **getPoolTransactions** - Get recent swap transactions, liquidity adds, and removes for a pool
8. **getTokenDetails** - Get detailed token information including price, volume, and liquidity across time windows
9. **getTokenPools** - Find all liquidity pools containing a specific token
10. **getTokenMultiPrices** - Fetch USD prices for up to 10 tokens in a single request
11. **search** - Search for tokens, pools, and DEXes by name, symbol, or address across all networks
12. **getStats** - Get high-level statistics about the DexPaprika ecosystem (chains, DEXes, pools, tokens)

## 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](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="Can I run the server read‑only?">
    Yes--most integrations should run read‑only; the examples show `--readonly`.
  </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": "Can I run the server read‑only?","acceptedAnswer": {"@type": "Answer","text": "Yes--use --readonly as shown in the examples."}}
      ]
    })}
</script>
