Skip to main content
Glama
Glebenjoy

dexscreener-mcp

by Glebenjoy

DexScreener MCP

An MCP server that gives Claude, Cursor, and any MCP-compatible agent live on-chain market data from DexScreener — 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."

Related MCP server: crypto-data-mcp

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:

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

Cursor

Add to .cursor/mcp.json:

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

Restart the client and the dexscreener tools appear.

Develop

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.


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?

Built by Gleb.

Available Tools

6 tools
get_pairA

Get details for a specific pair by chain id and pair (pool) address.

ParametersJSON Schema
NameRequiredDescriptionDefault
pairIdYesPair / pool address
chainIdYesChain id, e.g. 'solana', 'ethereum'

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral context. It only states 'Get details' without specifying the return structure, error behavior, or any side effects. For a simple read this is minimal, but it lacks sufficient detail given no output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with clear, front-loaded information. Every word earns its place, with no unnecessary details or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the low complexity (2 required params, no output schema), the description is adequate for a direct lookup but does not describe the response shape or usage edge cases. It is minimally viable but not rich enough to fully guide an agent without additional context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the description restates the parameters without adding new meaning. The schema already explains 'Pair / pool address' and chain id examples, so the description adds no semantic value beyond the structured fields.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('get') and a clear resource ('specific pair'), and explicitly identifies the lookup keys (chain id and pair address). This distinguishes it from siblings like search_pairs (search-based) and get_token_pools (by token).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when the exact chainId and pairId are known, but it does not mention alternatives or exclusions. There is no guidance on when to use search_pairs instead, leaving the agent to infer from sibling names.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_token_poolsA

Get all liquidity pools (pairs) for a specific token on a given chain.

ParametersJSON Schema
NameRequiredDescriptionDefault
chainIdYesChain id, e.g. 'solana', 'ethereum', 'base', 'bsc'
tokenAddressYesToken contract address

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It communicates a read-only operation via 'Get' and scopes results to a specific token and chain, but it does not disclose potential limitations such as supported chain formats, pagination, data volume, or the structure of each returned pool. This leaves some behavioral ambiguity.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that is front-loaded with the core action and object. There is no extraneous information, making it highly scannable and efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a simple read-only tool with two well-documented parameters and no output schema. The description sufficiently conveys what the tool does and the scope, but it does not elaborate on the format or fields of the returned pool objects. Given the simplicity and clear inputs, it is mostly complete but could benefit from a bit more detail on return structure.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for both parameters, with chainId and tokenAddress already well-described. The description only adds generic references to 'specific token' and 'given chain', providing no new semantic detail beyond the schema. Thus, the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly uses the verb 'Get' with a specific resource ('all liquidity pools (pairs) for a specific token on a given chain'). It distinguishes itself from sibling 'get_pair' by emphasizing 'all' pools, indicating it returns a collection rather than a single pair.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when one needs all pools for a specific token and chain, but it does not explicitly mention when to use this over alternatives like get_pair or search_pairs. No exclusions or alternative guidance are provided, so guidance is only implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_tokensA

Get pair/market data for one or more token addresses on a chain (comma-separated, up to 30).

ParametersJSON Schema
NameRequiredDescriptionDefault
chainIdYesChain id, e.g. 'solana', 'ethereum'
tokenAddressesYesOne or more token contract addresses, comma-separated

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must convey behavioral traits. It adds the constraint of up to 30 addresses and comma-separated format, which is valuable. However, it does not disclose potential errors, output shape, or whether only existing tokens are returned, limiting transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence that is concise and front-loaded with the core purpose, followed by a parenthetical constraint. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with only two required parameters and no output schema. The description covers the core function and input constraints, but lacks details on return format or behavior for invalid addresses, which would enhance completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes both parameters clearly, so the baseline is 3. The description adds the batch limit ('up to 30'), which is not in the schema, providing extra semantic value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'Get' and clearly identifies the resource as 'pair/market data' for token addresses, including a batch size limit. It distinguishes from siblings like get_pair (which likely handles a single pair) by supporting multiple addresses.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when needing market data for one or more token addresses, and the comma-separated format up to 30 indicates batch usage. However, it does not explicitly mention alternatives or when not to use this tool, leaving some ambiguity relative to sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

latest_token_profilesA

Get the latest token profiles freshly listed/updated on DexScreener (new tokens to watch).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must carry the transparency burden. It conveys that the tool returns recent token profiles but omits behavioral details such as ordering, pagination, time windows, or potential duplicates. The description is not misleading but provides minimal insight beyond the basic purpose.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that front-loads the verb 'Get' and immediately states the resource. It contains no filler or redundant information, making it highly concise and scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (no parameters, no output schema), the description adequately conveys what it does. It could be more explicit about the return format or that it returns a collection of profiles, but for a basic fetch tool the context is sufficient.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, and the input schema is empty with 100% coverage by definition. Per the rubric, 0 params earns a baseline of 4, and the description does not need to explain parameter semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool fetches 'latest token profiles freshly listed/updated on DexScreener' with the intent of finding 'new tokens to watch.' This specific verb+resource combination distinguishes it from sibling tools like 'top_boosted_tokens' or 'search_pairs'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a clear use case ('new tokens to watch') and implies it is for fresh listings/updates. However, it does not explicitly mention when not to use it or name alternative tools for different scenarios, such as searching for specific pairs or getting top boosted tokens.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_pairsA

Search DexScreener for trading pairs by token name, symbol, or contract address across all chains. Returns price, 24h change, volume, liquidity, and FDV.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesToken symbol, name, or address, e.g. 'PEPE', 'WIF', or a contract address

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description carries the full burden. It does disclose that the tool returns price, 24h change, volume, liquidity, and FDV, which is useful behavioral context. However, it omits any mention of pagination, result limits, data freshness, or potential edge cases (e.g., exact-match constraints). This is adequate but not thorough for a tool with zero annotation support.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with the primary action, and includes only essential information. Every word contributes: the search scope ('across all chains') and the return fields are useful and concise. There is no filler or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter read-only search tool, the description covers the purpose, input scope, and typical return data. It does not explain whether the result is a list or a single object, nor mention any response limits, which could be a minor gap. Overall, it is sufficient for straightforward invocation, but a bit more context on result shape would make it fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already fully describes the 'query' parameter with examples ('PEPE', 'WIF', contract address), giving 100% coverage. The tool description repeats the same semantics without adding new details or nuances beyond the schema. Baseline 3 applies because schema coverage is high and the description does not need to compensate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('Search'), the resource ('DexScreener trading pairs'), and the scope ('by token name, symbol, or contract address across all chains'). It differentiates from sibling tools like get_pair (exact pair lookup) and get_tokens (token lookup) by emphasizing broad search, and it also lists the returned data fields.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context for when to use this tool: when you need to find trading pairs via partial identifiers across all chains. However, it does not explicitly mention alternatives like get_pair or get_tokens, nor does it state when not to use it. It stops short of explicit exclusionary guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

top_boosted_tokensA

Get the currently top-boosted (most promoted / trending) tokens on DexScreener.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description carries full responsibility for behavioral disclosure. It mentions 'currently' and 'top-boosted' but does not explain ordering, pagination, data format, or any assumed read-only nature. The agent is left without critical behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no redundant words. It earns a perfect score for conciseness and structure.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no parameters and no output schema, the description provides the essential purpose but omits details about return shape, ordering, or limits. It is minimally viable but leaves gaps, especially since no output schema exists to clarify the response.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the input schema is trivially complete. Per rubric, with 0 params the baseline is 4; the description adds no parameter-specific meaning but also does not need to.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and resource ('top-boosted tokens on DexScreener'), with specific qualifiers ('currently', 'most promoted / trending'). This distinguishes it from sibling tools like latest_token_profiles by emphasizing trending/promoted status rather than recency.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives such as search_pairs or latest_token_profiles. There is no mention of use cases, exclusions, or complementary tools, leaving the agent to infer selection criteria.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv1.0.2
    • First observedget_pair
    • First observedget_token_pools
    • First observedget_tokens
    • First observedlatest_token_profiles
    • First observedsearch_pairs
    • First observedtop_boosted_tokens

TDQS

A3.9/5.0

Scored across 6 tools

Disambiguation4/5

Most tools target distinct data retrieval patterns: search, address lookups, pair details, and discovery lists. However, search_pairs and get_tokens both return pair data, which could cause confusion when an agent has a contract address.

Naming Consistency4/5

Predominantly verb_noun (search_pairs, get_token_pools, get_tokens, get_pair), but latest_token_profiles and top_boosted_tokens deviate from the verb pattern, making the set slightly inconsistent.

Tool Count5/5

Six tools cover the core DexScreener functionality without redundancy; the count is appropriate for a focused data provider.

Completeness4/5

The set covers search, direct address lookups, pair details, and discovery features. Missing historical/OHLC data but that's beyond the typical scope for first-level data access.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    An MCP server implementation that enables access to DexScreener API data, providing real-time information on DEX pairs, token profiles, and market statistics across multiple blockchains.
    7
    23
    -
  • A
    license
    A
    quality
    D
    maintenance
    Free MCP server for real-time cryptocurrency data. Get token prices, market overview, top movers, historical charts, and detailed token info directly in Claude Code, Cursor, or any MCP-compatible AI tool. Powered by CoinGecko with 70+ token mappings and built-in caching.
    5
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Real-time crypto market intelligence MCP. Get prices, trending coins, market overview, top coins by market cap, and portfolio value — all through natural language in Claude, Cursor, or any MCP client
    6
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    An MCP server that provides AI agents with real-time access to DEX liquidity pool data, enabling smarter trading, analytics, and automated strategies.
    10
    1
    MIT