dexjup-mcp
Provides tools for interacting with the Solana blockchain, including wallet balance checks, live swap quotes via Jupiter, and gated on-chain swap execution.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@dexjup-mcp What's the best Jupiter quote to swap 1 SOL for USDC?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 DEX Screener pairs by free text |
| All pools for a token, sorted by 24h volume |
| Detail for one specific pair by address |
| Batch lookup for up to 30 tokens in one call |
| Trending/boosted token profiles |
| Live Jupiter swap quote — no wallet, no execution |
| SOL + SPL balance for any address |
| Confirmation status of a transaction signature |
Aggregation:
Tool | What it does |
| 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 |
| 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 requiredLicense
MIT
Available Tools
11 toolsexecute_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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Crypto market intelligence, token rug-checks, and wallet verification in one MCP server.
23-in-1 MCP server: EVM tx simulator, funding rate arb, macro radar, swap calldata & security.
Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.
Solana MCP for wallets, trades, markets, PnL, transfers, onchain data, signable swaps and API tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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.29MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn 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 npm8MIT
- AlicenseAqualityDmaintenanceMCP 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.16MIT
- FlicenseAqualityCmaintenanceMCP server for Jupiter API on Solana, enabling immediate swaps via Ultra API and limit orders via Trigger API.101-