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