Skip to main content
Glama

dexjup-mcp

An MCP (Model Context Protocol) server combining DEX Screener market data with Jupiter (Solana DEX aggregator) quotes and gated swap execution — in one server.

Most existing MCP servers in this space do one or the other: pure DEX Screener reads with no execution, or Jupiter execution with no read-only mode and no safety guardrails. This server does both, with execution locked behind explicit opt-in, hard caps, and a confirm flag — see SECURITY.md before enabling trading.

Safety model (read this first if you plan to enable trading)

By default this server is read-only. execute_swap is listed but refuses to run unless you explicitly set TRADING_ENABLED=true, and even then every call is checked against server-side caps on swap size, slippage, and quote age before anything is signed. Full detail in SECURITY.md.

Related MCP server: @blockrun/alpha

Install / configure

Add to your MCP client config (e.g. Claude Desktop's claude_desktop_config.json or Claude Code's MCP settings):

{
  "mcpServers": {
    "dexjup": {
      "command": "npx",
      "args": ["-y", "dexjup-mcp"],
      "env": {
        "RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

That's enough for all read-only tools. See .env.example for every setting, and SECURITY.md before adding TRADING_ENABLED / SOLANA_PRIVATE_KEY.

Tools

Read-only (no wallet required):

Tool

What it does

search_pairs

Search DEX Screener pairs by free text

get_token_pairs

All pools for a token, sorted by 24h volume

get_pair

Detail for one specific pair by address

get_tokens

Batch lookup for up to 30 tokens in one call

get_token_profiles

Trending/boosted token profiles

get_jupiter_quote

Live Jupiter swap quote — no wallet, no execution

get_wallet_balance

SOL + SPL balance for any address

get_swap_status

Confirmation status of a transaction signature

Aggregation:

Tool

What it does

get_token_overview

Merges DEX Screener market data with a live Jupiter reference quote for one token; degrades gracefully if either source has nothing

Write (gated — see SECURITY.md):

Tool

What it does

execute_swap

Executes a real on-chain swap against a previously-fetched quote

Development

npm install
npm run build
npm run inspector   # opens MCP Inspector against the built server
npm test            # unit tests, no network/funds required

License

MIT

Available Tools

11 tools
execute_swapExecute a live swapA

Executes a REAL on-chain swap using a quote previously obtained from get_jupiter_quote or get_token_overview. Requires TRADING_ENABLED=true on the server and confirm: true on the call. Subject to server-side caps on amount, slippage, and quote freshness regardless of what is requested. This tool is always listed, even when trading is disabled, in which case it returns a structured refusal.

Inputs: quote (required), confirm (required), quoteFetchedAt (required).

get_jupiter_quoteGet a Jupiter swap quoteA

Get a live Jupiter swap quote. Read-only — no wallet needed, executes nothing. Amounts are in the input mint's smallest unit (e.g. lamports for SOL). The returned quote is required as input to execute_swap.

Inputs: amount (required), inputMint (required), outputMint (required), slippageBps.

get_pairGet a single DEX pairA

Get full detail for one specific DEX pair/pool by its pair address.

Inputs: pairId (required), chainId (required).

get_swap_statusGet transaction statusA

Check the confirmation status of a previously-submitted transaction signature, e.g. one returned by execute_swap. Read-only.

Inputs: signature (required).

get_token_overviewGet a merged token overviewA

Combines DEX Screener market data (liquidity, volume, price change, socials) with a live Jupiter reference quote (1 SOL -> token) into one enriched response. Degrades gracefully: if the token has no DEX Screener listing or no Jupiter route, the other half of the response is still returned.

Inputs: tokenAddress (required), chainId.

get_token_pairsGet pools for a tokenA

List all DEX pools/pairs for a given token mint/contract address, sorted by 24h volume descending.

Inputs: tokenAddress (required), chainId.

get_token_profilesGet trending token profilesA

List the latest trending/boosted token profiles from DEX Screener, optionally filtered to one chain.

Inputs: chainFilter.

get_tokensBatch token lookupA

Look up DEX pair data for up to 30 token addresses in a single call. Use this instead of repeated get_token_pairs calls when checking a list of tokens.

Inputs: tokenAddresses (required), chainId.

get_wallet_balanceGet wallet balanceA

Get the SOL balance (and optionally an SPL token balance) for a wallet address. If walletAddress is omitted, defaults to the server's configured trading wallet when trading is enabled.

Inputs: mintAddress, walletAddress.

pingPingA

Health check tool. Returns pong plus the current server time.

Inputs: no named parameters.

search_pairsSearch DEX pairsA

Search DEX Screener for trading pairs matching free text, e.g. a token symbol or a pair like 'SOL/USDC'. Not scoped to one chain.

Inputs: query (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 11 tools

    Disambiguation4/5

    Each tool has a distinct purpose: health check, trending tokens, quotes, token overview, wallet balance, swap status, swap execution, pair search, token pairs, pair detail, and batch lookup. The only minor overlap is between get_token_pairs and get_tokens, but the batch nature of get_tokens is clearly documented.

    Naming Consistency5/5

    Tool names follow a consistent snake_case verb-noun pattern (ping, get_*, search_pairs, execute_swap). There is no mixing of camelCase or inconsistent verb styles.

    Tool Count5/5

    With 11 tools, the server is well-scoped for DEX data and swap execution. Each tool serves a clear function without redundancy, fitting comfortably within the ideal 3-15 range.

    Completeness4/5

    The tool surface covers the core lifecycle of querying DEX data, obtaining quotes, executing swaps, and checking swap status, plus wallet balance. Gaps like historical price data or transaction history are minor and don't block primary workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for executing token swaps on the Solana blockchain using Jupiter's Ultra API, enabling users to fetch optimal swap orders and execute transactions with slippage control.
      29
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An AI-powered crypto trading MCP server providing technical analysis, market sentiment, and token swap execution via 0x and DexScreener. It enables users to manage portfolios with built-in risk limits and search historical trade data using vector-based memory.
      9 npm
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server providing AI agents with native access to Jupiter's full DeFi stack on Solana. It offers 17 tools covering swaps, tokens, lending, limit orders, DCA, prediction markets, perpetuals, and portfolio management.
      16
      MIT