jupiter-mcp
MCP server for the Jupiter Developer Platform — 17 tools covering swap, tokens, price, lend, limit orders, DCA, prediction markets, perps, and portfolio.
Any MCP-compatible AI agent (Claude Code, Cursor, ChatGPT, etc.) gets native access to Jupiter's full DeFi stack on Solana.
Quick Start
# Install
git clone https://github.com/ExpertVagabond/jupiter-mcp.git
cd jupiter-mcp
npm install && npm run build
# Run (keyless — 0.5 RPS, no signup needed)
node dist/index.js
# Run with API key (higher rate limits)
JUPITER_API_KEY=your_key node dist/index.js
Add to Claude Code
// ~/.claude/settings.json
{
"mcpServers": {
"jupiter": {
"command": "node",
"args": ["/path/to/jupiter-mcp/dist/index.js"],
"env": {
"JUPITER_API_KEY": "your_key_or_omit_for_keyless"
}
}
}
}
Tools (17)
| Tool | Description |
|---|---|
jupiter_swap_quote | Get swap quote via managed /order path (all routers compete) |
jupiter_swap_build | Get raw swap instructions for custom transactions |
jupiter_token_search | Search tokens by name, symbol, or mint |
jupiter_token_info | Token metadata, organic scores, trading metrics |
jupiter_price | USD prices for any Solana token |
jupiter_lend_deposit | Create a lending deposit transaction |
jupiter_lend_withdraw | Create a lending withdrawal transaction |
jupiter_limit_orders | List open limit orders for a wallet |
jupiter_limit_order_create | Create limit / OCO / OTOCO orders |
jupiter_limit_order_cancel | Cancel open limit orders |
jupiter_dca_orders | List active DCA schedules |
jupiter_dca_create | Create recurring DCA orders |
jupiter_prediction_events | Browse prediction markets (Polymarket, Kalshi) |
jupiter_perps_markets | List perpetual futures markets |
jupiter_perps_positions | Get open perp positions |
jupiter_portfolio | Full portfolio view across all Jupiter products |
Example
You: "What's the price of SOL and JUP?"
Agent calls: jupiter_price({ mints: "So11...112,JUPyi...vCN" })
→ SOL: $83.53 (-2.4% 24h), JUP: $0.166
You: "Get me a quote to swap 1 SOL for USDC"
Agent calls: jupiter_swap_quote({
inputMint: "So11111111111111111111111111111111111111112",
outputMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
amount: "1000000000",
taker: "your_wallet"
})
→ 83.48 USDC, 22bps slippage, aggregator routing via Raydium
Architecture
src/
index.ts MCP server entry — registers all tools
client.ts Jupiter API client (thin fetch wrapper, no dependencies)
types.ts Shared types
tools/
swap.ts Swap V2 (/order + /build)
tokens.ts Token search + metadata
price.ts USD pricing
lend.ts Lending deposit/withdraw
trigger.ts Limit orders (create/cancel/list)
recurring.ts DCA orders
prediction.ts Prediction markets
perps.ts Perpetual futures
portfolio.ts Portfolio aggregation
DX Report
See DX-REPORT.md for a detailed developer experience report covering every Jupiter API, the AI stack (llms.txt, Agent Skills, CLI, Docs MCP), and specific recommendations.
License
MIT