> ## 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 Hosted MCP Server

> Access real-time DeFi data in Claude, Cursor, and other MCP-compatible tools without any installation or setup. Our hosted MCP server provides instant access to comprehensive DEX data across 36 blockchains.

## Integration overview

Use the hosted MCP server URL to enable streaming DeFi data in Claude, Cursor, and other MCP clients.

> [!NOTE]
>
> Having trouble connecting? We're here to help - [reach out](mailto:support@coinpaprika.com) and we'll get you up and running.

## Why use our hosted MCP server?

Skip installation entirely. The hosted MCP server is a keyless URL you drop into any MCP client to query live DeFi data across 36 networks.

**What you get instantly:**

* **Zero setup required** - just add the URL to your config
* **Multiple transport options** - SSE, streamable HTTP, and JSON-RPC support
* **Always up-to-date** - we run the server, handle updates, and index new pools
* **Keyless to start** - query without an API key or signup, at 10,000 credits per rolling 30 days per IP
* **Live market data** - current prices, volumes, and pool information
* **36 blockchain networks** - Ethereum, Solana, Base, Arbitrum, and more

> [!NOTE]
>
> Visit [mcp.dexpaprika.com](https://mcp.dexpaprika.com) to explore our hosted MCP server interface and see the available data before integrating.

***

## Quick integration guide

### Claude desktop setup

Add our hosted MCP server to Claude Desktop in just 2 steps:

**1. Locate your configuration file**

Find your Claude Desktop configuration file:

* **macOS**: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
* **Linux**: `~/.config/Claude/claude_desktop_config.json`

**2. Add the hosted server configuration**

If the file doesn't exist, create it with this content:

```json theme={null}
{
  "mcpServers": {
    "dexpaprika": {
      "url": "https://mcp.dexpaprika.com/sse"
    }
  }
}
```

If the file already exists, add our server to the existing `mcpServers` object:

```json theme={null}
{
  "mcpServers": {
    "dexpaprika": {
      "url": "https://mcp.dexpaprika.com/sse"
    }
  }
}
```

Save the file and restart Claude Desktop. You're ready to go!

### Cursor setup

**1. Access MCP settings**

1. Open Cursor IDE
2. Go to **Settings** (Cmd/Ctrl + ,)
3. Navigate to **Tools & Integrations**
4. Click **New MCP server**

**2. Configure in mcp.json**

This will open the `mcp.json` file. Add the DexPaprika server configuration:

```json theme={null}
{
  "mcpServers": {
    "dexpaprika": {
      "url": "https://mcp.dexpaprika.com/sse"
    }
  }
}
```

Save the file and restart Cursor if needed.

### ChatGPT integration

Want to use DexPaprika data in ChatGPT? You can integrate our API directly into ChatGPT using Actions:

1. **Create a custom GPT** in ChatGPT (requires Plus or Enterprise subscription)
2. **Add our OpenAPI specification** from [mcp.dexpaprika.com/openapi](https://mcp.dexpaprika.com/openapi)
3. **Start asking crypto questions** directly in your ChatGPT conversations

> [!NOTE]
>
> **Ready to set up ChatGPT?** Follow our complete [ChatGPT Actions integration guide](https://docs.dexpaprika.com/ai-integration/chatgpt-actions.md) for step-by-step instructions.

***

## Connection options

Our hosted MCP server supports multiple transport protocols to ensure compatibility with different clients and use cases:

> **Server-sent events (SSE) - Recommended**
>
> **Endpoint:** `https://mcp.dexpaprika.com/sse`
>
> **Best for:** Claude Desktop, Cursor, and most MCP clients\
> **Benefits:** Real-time streaming updates, excellent browser compatibility, automatic reconnection\
> **Use cases:** Live price monitoring, real-time pool updates, continuous market data feeds
>
> This is the recommended option for most users as it provides the smoothest experience with popular AI tools.

> **Streamable HTTP**
>
> **Endpoint:** `https://mcp.dexpaprika.com/streamable-http`
>
> **Best for:** Custom applications, web services, and clients that prefer HTTP streaming\
> **Benefits:** Standard HTTP protocol, works well with firewalls, easier debugging\
> **Use cases:** Integration with existing web infrastructure, corporate environments with strict network policies
>
> Perfect for developers building custom integrations or working in environments where SSE might be restricted.

> **JSON-RPC over HTTP**
>
> **Endpoint:** `https://mcp.dexpaprika.com/json-rpc`
>
> **Best for:** Traditional API integrations, batch processing, simple request-response patterns\
> **Benefits:** Familiar REST-like interface, stateless communication, easy to cache\
> **Use cases:** Periodic data fetching, batch analysis, integration with existing JSON-RPC systems
>
> Ideal for applications that don't need real-time updates and prefer traditional API communication patterns.

> [!TIP]
>
> **Getting started?** Use the SSE endpoint (`https://mcp.dexpaprika.com/sse`) for the best experience with Claude Desktop and Cursor. You can always switch protocols later based on your specific needs.

> [!NOTE]
>
> **Need help choosing?** Visit [mcp.dexpaprika.com](https://mcp.dexpaprika.com) to test different connection methods and see which works best for your setup.

***

## Your own API key, for token OHLCV and pool transactions

Three tools need a Dev, Pro or Enterprise plan, and on the hosted server they run on your key, never on ours. `getTokenOHLCV` returns USD candles for a token, volume-weighted across every pool it trades in on a network (see the [token OHLCV tutorial](https://docs.dexpaprika.com/tutorials/token-ohlcv.md)). `getTokenIndicator` computes RSI, EMA, MACD, Bollinger Bands or VWAP from those token candles (see the [technical indicators tutorial](https://docs.dexpaprika.com/tutorials/technical-indicators.md)); `getPoolIndicator` gives the same for a single pool on every plan with no key. `getPoolTransactions` returns a pool's recent swaps; the [pool transactions endpoint](https://docs.dexpaprika.com/api-reference/pools/get-transactions-of-a-pool-on-a-network-paging-can-be-used-up-to-100-pages.md) behind it is paid-only since 30 September 2026. Every other tool works the same with or without a key.

Add the key as the `Authorization` header on your connection to the server, the key on its own. Get it in [console.dexpaprika.com](https://console.dexpaprika.com); plans are on [pricing](https://dexpaprika.com/api/pricing).

**Claude Code**

```bash theme={null}
claude mcp add --transport http dexpaprika https://mcp.dexpaprika.com/streamable-http --header "Authorization: YOUR_API_KEY"
```

**Cursor**

In `~/.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "dexpaprika": {
      "url": "https://mcp.dexpaprika.com/streamable-http",
      "headers": { "Authorization": "YOUR_API_KEY" }
    }
  }
}
```

**JSON-RPC**

```bash theme={null}
curl -s https://mcp.dexpaprika.com/json-rpc \
  -H "Content-Type: application/json" \
  -H "Authorization: $DEXPAPRIKA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"getTokenOHLCV","arguments":{"network":"ethereum","token_address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","start":"-24h","interval":"1h","limit":24}}}'
```

* **Reconnect after adding or changing the key.** The server reads it when a session opens, so restart the client or reload the server. JSON-RPC reads it on every request.
* **Errors say what to fix.** With no key the tool answers `DP401_API_KEY_REQUIRED` and calls nothing. A key the API rejects answers `DP401_INVALID_API_KEY`, and a key whose plan does not cover the request answers `DP403_PLAN_REQUIRED`. Agents are told to fall back: to `getPoolOHLCV` or `getPoolIndicator` on the token's most liquid pool for candles and indicators, and to `getPoolDetails` for a pool's transaction counts.
* **The key goes nowhere else.** It is sent only with these three tools' requests to `api-pro.dexpaprika.com`. It is not logged, and it is kept only with your session, which is deleted with it.
* **Clients that cannot set headers**, such as connectors added by URL alone, can use every tool except these three.

***

## Available features

Our hosted MCP server provides comprehensive access to DeFi data:

### Core data access

* **Multi-chain support** - 36 blockchain networks including Ethereum, Solana, Base, Arbitrum, Polygon, and more
* **Real-time prices** - Live token prices and market data
* **Liquidity pools** - Detailed pool information, volumes, and fees
* **DEX analytics** - Trading data across major decentralized exchanges
* **Search functionality** - Find tokens, pools, and DEXes across all networks

> [!NOTE]
>
> Batch token pricing via [`GET /networks/{network}/multi/prices`](https://docs.dexpaprika.com/api-reference/tokens/get-batched-prices-for-multiple-tokens-on-a-network) for efficient multi-token lookups (up to 10 tokens per request).

### Advanced analytics

* **Historical data** - Price history and trading volumes over time
* **Pool monitoring** - Track new pool creation and liquidity changes
* **Cross-chain comparisons** - Compare prices and liquidity across different networks
* **Volume analysis** - Trading volume trends and patterns

***

## Usage examples

Once configured, you can ask Claude or Cursor powerful questions about DeFi data:

### Example queries you can make

| Category | Example Query |
| - | - |
| **Basic market data** | "What are the top 5 liquidity pools by volume today?" |
| **Network information** | "Which blockchain networks does DexPaprika support?" |
| **Token prices** | "What's the current price of SOL across different DEXes?" |
| **Pool analysis** | "Show me the most liquid USDC/ETH pools across all networks and compare their trading fees" |
| **New opportunities** | "Find newly created liquidity pools in the last 24 hours with volume over \$100k" |
| **Cross-chain comparison** | "Compare ETH prices between Ethereum mainnet and Layer 2 solutions like Arbitrum and Base" |
| **DEX performance** | "Which DEX has the highest trading volume on Solana today?" |
| **Token discovery** | "Search for meme tokens with high trading volume in the last hour" |
| **Arbitrage opportunities** | "Find price differences for USDC across different DEXes on Ethereum" |

> [!TIP]
>
> **Want to explore more?** Visit [mcp.dexpaprika.com](https://mcp.dexpaprika.com) to test the interface, check out our [tutorials](https://docs.dexpaprika.com/tutorials/tutorial_intro.md) for step-by-step guides, or browse the [API documentation](https://docs.dexpaprika.com/api-reference/introduction.md) for technical details.

***

## Benefits over self-hosted solutions

| Feature | Hosted MCP | Self-Hosted MCP |
| - | - | - |
| **Setup time** | \< 2 minutes | 15-30 minutes |
| **Maintenance** | Zero - we handle it | Regular updates required |
| **Reliability** | Managed and monitored by us | Depends on your infrastructure |
| **Edge caching** | Yes | No |
| **Updates** | Automatic | Manual intervention |

***

## Troubleshooting

### Common issues and solutions

> **Server not responding or connection timeout**
>
> **Symptoms**: Claude shows connection errors or timeouts when making requests.
>
> **Solutions**:
>
> 1. Check your internet connection
> 2. Restart Claude Desktop/Cursor
> 3. Verify the configuration syntax in your config file
> 4. Try removing and re-adding the server configuration

> **Configuration file not found**
>
> **Symptoms**: Can't locate the Claude Desktop configuration file.
>
> **Solutions**:
>
> 1. Create the directories if they don't exist:
>    * **macOS**: `mkdir -p ~/Library/Application\ Support/Claude/`
>    * **Windows**: Create the `Claude` folder in your `%APPDATA%` directory
> 2. Create the `claude_desktop_config.json` file manually
> 3. Ensure proper JSON syntax

> **MCP server not listed in Claude**
>
> **Symptoms**: The DexPaprika server doesn't appear in Claude's available tools.
>
> **Solutions**:
>
> 1. Verify JSON syntax in your configuration file
> 2. Restart Claude Desktop completely
> 3. Check that the server URL is correct: `https://mcp.dexpaprika.com/sse`
> 4. Try removing and re-adding the server configuration

> **Rate limiting or API errors**
>
> **Symptoms**: Getting rate limit errors or API failures.
>
> **Solutions**:
>
> 1. Our hosted service includes built-in rate limiting protection
> 2. `DP429_RATE_LIMITED` means the server's shared capacity is busy. Wait `retry_after_seconds` when it is given, then retry. Your own plan does not change this, except for the tools that run on your own key (see above), which count against your plan like any direct call
> 3. Try spacing out your requests if making many in quick succession

***

## API coverage

Our hosted MCP server provides access to all DexPaprika API endpoints:

> **[Networks & DEXes](https://docs.dexpaprika.com/api-reference/networks/get-a-list-of-available-blockchain-networks.md)**
>
> Access all supported blockchain networks and their available decentralized exchanges

> **[Liquidity Pools](https://docs.dexpaprika.com/api-reference/pools/advanced-pool-filtering-on-a-specific-network.md)**
>
> Comprehensive pool data including TVL, volume, fees, and token pairs

> **[Token Information](https://docs.dexpaprika.com/api-reference/tokens/get-a-tokens-latest-data-on-a-network.md)**
>
> Real-time token prices, market data, and detailed token information

> **[Historical Data](https://docs.dexpaprika.com/api-reference/pools/get-ohlcv-data-for-a-pool-pair.md)**
>
> Price history, volume trends, and historical pool performance

> **[Search & Discovery](https://docs.dexpaprika.com/api-reference/search/search-for-tokens-pools-and-dexes.md)**
>
> Powerful search across tokens, pools, and DEXes with filtering options

> **[Real-time Updates](https://docs.dexpaprika.com/api-reference/introduction.md)**
>
> Live data feeds with the latest market information and trading activity

***

## What's next?

> **[API Documentation](https://docs.dexpaprika.com/api-reference/introduction.md)**
>
> Explore all available data endpoints and their capabilities

> **[Find New Pools](https://docs.dexpaprika.com/tutorials/find-new-pools.md)**
>
> Learn how to discover newly created liquidity pools and tokens

> **[Self-Hosted Option](https://docs.dexpaprika.com/ai-integration/mcp.md)**
>
> Want to run your own MCP server? Check out our self-hosted guide

> **[Historical Data](https://docs.dexpaprika.com/tutorials/retrieve-historical-data.md)**
>
> Access and analyze historical price and volume data

## Need help?

> **[Join Our Discord](https://discord.gg/DhJge5TUGM)**
>
> Connect with our community and get real-time support from other builders

> **[Direct Support](mailto:support@coinpaprika.com)**
>
> Reach out directly for technical support or feature requests

> [!NOTE]
>
> **Looking for custom integrations?** Our team can help you integrate DexPaprika data into any application or workflow. [Contact us](mailto:support@coinpaprika.com) to discuss your specific needs.

### FAQs

> **Do I need an API key to use the hosted MCP?**
>
> Not for most tools. Add the hosted URL to your client config and every tool except `getTokenOHLCV`, `getTokenIndicator` and `getPoolTransactions` works with no key and no signup. Those three run on your own Dev, Pro or Enterprise key; see [your own API key](#your-own-api-key-for-token-ohlcv-and-pool-transactions).

> **Which transport should I choose?**
>
> Start with SSE for streaming and broad compatibility. Use streamable HTTP or JSON-RPC if your environment restricts SSE.

> **How do I debug connection issues?**
>
> Confirm the URL, restart the client, and test the endpoint in a browser. If using desktop apps, ensure your config JSON is valid.

> **Is rate limiting applied?**
>
> Yes. Tool calls run on the server's shared capacity, not on a plan of yours, so when it is busy a tool returns `DP429_RATE_LIMITED`, with `retry_after_seconds` when the API supplies one. Wait that long and retry. `getTokenOHLCV`, `getTokenIndicator` and `getPoolTransactions` are the exception: they run on your own key and count against your plan like any direct call. For the REST API's own limits, see [rate limits](https://docs.dexpaprika.com/knowledge-base/rate-limits.md) and [pricing](https://dexpaprika.com/api/pricing).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.