Jupiter MCP Server

An MCP server for executing token swaps on the Solana blockchain using Jupiter's new Ultra API.

Features

• Fetch swap orders from Jupiter's Ultra API, combining DEX routing and RFQ (Request for Quote) for optimal pricing.
• Execute swaps via Jupiter's Ultra API, handling slippage, priority fees, and transaction landing.

Prerequisites

• Node.js: Version 18 or higher (for native fetch support).
• Solana Wallet: A private key (base58-encoded) for signing transactions.
• RPC Endpoint: Access to a Solana RPC node (e.g., https://api.mainnet-beta.solana.com).

Installation

1. Clone the Repository:

   git clone https://github.com/kukapay/jupiter-mcp.git
   cd jupiter-mcp
   

2. Install Dependencies: Ensure you have the MCP Server package installed along with other required dependencies:

   npm install
   

3. Client Configuration:

   {
     "mcpServers": {
       "Jupiter-MCP": {
         "command": "node",
         "args": ["path/to/jupiter-mcp/server/index.js"],
         "env": {
           "SOLANA_RPC_URL": "solana rpc url you can access",
           "PRIVATE_KEY": "your private key"
         }
       }
     }
   }
   

Tools# Ultra API Tools

• get-ultra-order:
• Description: Fetches a swap order from Jupiter's Ultra API, leveraging both DEX routing and RFQ for optimal pricing.
• Inputs:
• inputMint: Input token mint address (e.g., SOL or token pubkey).
• outputMint: Output token mint address (e.g., USDC or token pubkey).
• amount: Input amount as a string (e.g., "1.23").
• slippageBps: Slippage tolerance in basis points (e.g., 50 for 0.5%).
• Output: JSON with requestId, transaction (base64-encoded), inputMint, outputMint, inAmount, outAmount, price.
• execute-ultra-order:
• Description: Requests Jupiter to execute the swap transaction on behalf of the wallet owner, handling slippage, priority fees, and transaction landing.
• Inputs:
• requestId: Unique identifier from get-ultra-order.
• transaction: Base64-encoded transaction from get-ultra-order.
• Output: JSON with status, transactionId, slot, inputAmountResult, outputAmountResult, swapEvents.

License

This project is licensed under the MIT License. See the LICENSE file for details.