openSVM/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. getlatesttokenprofiles
Get the latest token profiles
No parameters required
typescript
const result = await mcpClient.callTool('dexscreener', 'getlatesttokenprofiles');
2. getlatestboostedtokens
Get the latest boosted tokens
No parameters required
typescript
const result = await mcpClient.callTool('dexscreener', 'getlatestboostedtokens');
3. gettopboostedtokens
Get tokens with most active boosts
No parameters required
typescript
const result = await mcpClient.callTool('dexscreener', 'gettopboostedtokens');
4. gettokenorders
Check orders paid for a specific token
typescript
const result = await mcpClient.callTool('dexscreener', 'gettokenorders', {
chainId: 'solana',
tokenAddress: 'So11111111111111111111111111111111111111112'
});
5. getpairsbychainandaddress
Get one or multiple pairs by chain and pair address
typescript
const result = await mcpClient.callTool('dexscreener', 'getpairsbychainandaddress', {
chainId: 'solana',
pairId: 'HxFLKUAmAMLz1jtT3hbvCMELwH5H9tpM2QugP8sKyfhc'
});
6. getpairsbytokenaddresses
Get one or multiple pairs by token address (max 30)
typescript
const result = await mcpClient.callTool('dexscreener', 'getpairsbytokenaddresses', {
tokenAddresses: 'So11111111111111111111111111111111111111112'
});
7. searchpairs
Search for pairs matching query
typescript
const result = await mcpClient.callTool('dexscreener', 'searchpairs', {
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.