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

# Installing MCP Server for DexPaprika

> Integrating DexPaprika data with Claude.ai using Model Context Protocol (MCP)

## 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 customized by Claude](https://modelcontextprotocol.io/introduction) for establishing unified context interaction between AI models and development environments, enabling AI to better understand and process code. 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
```

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`
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 all 33 supported blockchain networks and their 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>