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.

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