DexScreener MCP server

Integrates with decentralized exchanges across multiple blockchains to provide real-time crypto market data, focusing on Solana memecoin markets.
Back to servers
Setup instructions
Provider
openSVM
Release date
Jan 06, 2025
Language
TypeScript
Stats
12 stars

The DexScreener MCP Server provides real-time access to DEX pair data, token information, and market statistics across multiple blockchains through a standardized Model Context Protocol implementation. It integrates seamlessly with Claude Desktop and other MCP-compatible clients.

Installation

You can install the DexScreener MCP Server in two ways:

Quick Installation

The simplest method is to use the one-line installer, which automatically adds the server to Claude Desktop:

curl -L https://raw.githubusercontent.com/opensvm/dexscreener-mcp-server/main/install.sh | bash

Manual Installation

If you prefer manual installation:

npm install
npm run build
npm run setup

Usage

The server provides access to several tools for accessing DexScreener data. Here's how to use each one with an MCP client:

Getting Token Information

Latest Token Profiles

Retrieves the latest token profiles:

const result = await mcpClient.callTool('dexscreener', 'get_latest_token_profiles');

Latest Boosted Tokens

Gets the most recently boosted tokens:

const result = await mcpClient.callTool('dexscreener', 'get_latest_boosted_tokens');

Top Boosted Tokens

Retrieves tokens with the most active boosts:

const result = await mcpClient.callTool('dexscreener', 'get_top_boosted_tokens');

Token Orders

Checks orders paid for a specific token:

const result = await mcpClient.callTool('dexscreener', 'get_token_orders', {
  chainId: 'solana',
  tokenAddress: 'So11111111111111111111111111111111111111112'
});

Getting Pair Information

Pairs by Chain and Address

Retrieves pairs by their chain and address:

const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_chain_and_address', {
  chainId: 'solana',
  pairId: 'HxFLKUAmAMLz1jtT3hbvCMELwH5H9tpM2QugP8sKyfhc'
});

Pairs by Token Addresses

Gets pairs by token address (maximum 30):

const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_token_addresses', {
  tokenAddresses: 'So11111111111111111111111111111111111111112'
});

Search Pairs

Searches for pairs matching a specific query:

const result = await mcpClient.callTool('dexscreener', 'search_pairs', {
  query: 'SOL'
});

Rate Limits

Be aware that the server implements rate limiting to comply with DexScreener's API requirements:

  • Token Profile/Boost endpoints: Limited to 60 requests per minute
  • DEX/Pairs endpoints: Limited to 300 requests per minute

When rate limits are exceeded, the server will return appropriate error messages.

Error Handling

The server provides comprehensive error handling for various scenarios:

  • Rate limit exceeded
  • Invalid parameters
  • Network errors
  • API errors

Errors are returned in a standardized format with descriptive messages to help troubleshoot issues quickly.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "dexscreener" '{"command":"npx","args":["-y","@opensvm/dexscreener-mcp-server"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "dexscreener": {
            "command": "npx",
            "args": [
                "-y",
                "@opensvm/dexscreener-mcp-server"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your 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 this to your configuration file:

{
    "mcpServers": {
        "dexscreener": {
            "command": "npx",
            "args": [
                "-y",
                "@opensvm/dexscreener-mcp-server"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later