trackmcp
Back to directory
opensvm

dexscreener-mcp-server

View on GitHub
19 stars JavaScriptServers & Infrastructure Updated Oct 1, 2025

Documentation

DexScreener MCP Server

An MCP server implementation for accessing the DexScreener API, providing real-time access to DEX pair data, token information, and market statistics across multiple blockchains.

One-line install (automatically adds to Claude Desktop):

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

Features

  • Rate-limited API access (respects DexScreener's rate limits)
  • Comprehensive error handling
  • Type-safe interfaces
  • Support for all DexScreener API endpoints
  • Integration tests

Installation

Manual installation:

bash
npm install
npm run build
npm run setup

Testing

bash
npm test

Usage

Available Tools

1. `get_latest_token_profiles`

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

    2. `get_latest_boosted_tokens`

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

      3. `get_top_boosted_tokens`

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

        4. `get_token_orders`

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

          5. `get_pairs_by_chain_and_address`

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

            6. `get_pairs_by_token_addresses`

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

              7. `search_pairs`

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

                Rate Limits

                The server implements rate limiting to comply with DexScreener's API limits:

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

                Error Handling

                The server handles various error scenarios:

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

                Errors are returned in a standardized format with appropriate error codes and messages.

                API Documentation

                For detailed API documentation, see docs/api-reference.md.

                Development

                Project Structure

                code
                .
                ├── src/
                │   ├── types/           # TypeScript interfaces and types
                │   ├── services/        # API service implementations
                │   ├── tests/           # Integration tests
                │   └── index.ts         # Main server implementation
                ├── scripts/            # Setup and utility scripts
                ├── docs/              # Documentation
                └── README.md          # This file

                Adding New Features

                1. Define types in `src/types/`

                2. Implement service methods in `src/services/`

                3. Add tool handlers in `src/index.ts`

                4. Update documentation

                5. Add tests

                License

                MIT

                Frequently asked questions

                What is dexscreener-mcp-server?

                dexscreener-mcp-server is a Model Context Protocol (MCP) server listed in the TrackMCP directory.

                How do I install dexscreener-mcp-server?

                Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

                Is dexscreener-mcp-server open source?

                Yes — it is hosted on GitHub at https://github.com/opensvm/dexscreener-mcp-server and has 19 stars.

                Related MCP tools

                Run your own MCP server? See who uses it and what to fix.

                Measure it with TrackMCP