# DexScreener MCP

An [MCP](https://modelcontextprotocol.io) server that gives Claude, Cursor, and any
MCP-compatible agent **live on-chain market data from [DexScreener](https://dexscreener.com)** —
search pairs, inspect tokens and pools, and pull trending/boosted tokens across every chain.

No API key. No signup. The public DexScreener API is free (rate limited to ~60 req/min).

> Most "MCP for X" repos are half-finished and break on the second request. This one ships
> with tests and graceful error handling so an agent can actually rely on it.

## What your agent can do

Ask things like:

- "Search DexScreener for WIF and give me the top pairs by volume."
- "What's trending / getting boosted on Solana right now?"
- "Show me every pool for this token address on Base."
- "Compare 24h volume and liquidity for these three contracts."

## Tools

| Tool | What it does |
|------|--------------|
| `search_pairs` | Search pairs by symbol, name, or address across all chains |
| `get_token_pools` | All liquidity pools for a token on a chain |
| `get_tokens` | Market data for one or more token addresses (comma-separated) |
| `get_pair` | Details for a specific pair/pool address |
| `latest_token_profiles` | Freshly listed/updated tokens to watch |
| `top_boosted_tokens` | Currently top-promoted / trending tokens |

## Install

No install needed. It runs straight from npm via `npx`.

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "dexscreener": {
      "command": "npx",
      "args": ["-y", "dexscreener-mcp"]
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "dexscreener": {
      "command": "npx",
      "args": ["-y", "dexscreener-mcp"]
    }
  }
}
```

Restart the client and the `dexscreener` tools appear.

## Develop

```bash
npm install
npm run dev     # run from TypeScript source over stdio
npm test        # run the unit tests
npm run build   # compile to dist/
```

## Supported chains

Any chain DexScreener indexes — `solana`, `ethereum`, `base`, `bsc`, `arbitrum`, `polygon`, and more.
Pass the chain id as `chainId`.

## License

MIT — see [LICENSE](./LICENSE).

---

## Hire me

I build custom MCP servers and AI systems (multi-agent, RAG, automation). Need a connector for your own API, or a full AI integration?

- Hire me on Upwork: https://www.upwork.com/freelancers/~01946645ed245c263d
- Or open an issue on this repo.

Built by Gleb.