What is Jupiter Mcp

Jupiter-MCP is a server designed for executing token swaps on the Solana blockchain using Jupiter’s Ultra API, which optimizes pricing through DEX routing and RFQ (Request for Quote).

Use cases

Use cases include executing token swaps for trading, liquidity provision, and optimizing transaction costs in DeFi applications.

How to use

To use Jupiter-MCP, clone the repository, install the necessary dependencies, and configure the client with your Solana RPC URL and private key. Then, run the server to start executing token swaps.

Key features

Key features include fetching swap orders from Jupiter’s Ultra API, executing swaps while managing slippage, priority fees, and transaction landing.

Where to use

Jupiter-MCP is primarily used in the decentralized finance (DeFi) sector, particularly for token swaps on the Solana blockchain.

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.

Example Interaction

Below are examples of interacting with the server using natural language prompts and expected responses:

Fetching a Swap Order

• Prompt: “Get a swap order to trade 1.23 SOL for USDC.”
• Input:
  • Tool: get-ultra-order
  • Arguments:
    • inputMint: “So11111111111111111111111111111111111111112” (SOL)
    • outputMint: “EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v” (USDC)
    • amount: “1.23”
    • slippageBps: 50
• Response:

  {
    "requestId": "a770110b-82c9-46c8-ba61-09d955b27503",
    "transaction": "AQAAAA...base64-encoded-transaction...==",
    "inputMint": "So11111111111111111111111111111111111111112",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "inAmount": "1230000000",
    "outAmount": "19950000",
    "price": 0.01621951219512195
  }
  

Executing a Swap

• Prompt: “Execute the swap order with request ID ‘a770110b-82c9-46c8-ba61-09d955b27503’ using the transaction provided.”
• Input:
  • Tool: execute-ultra-order
  • Arguments:
    • requestId: “a770110b-82c9-46c8-ba61-09d955b27503”
    • transaction: “AQAAAA…base64-encoded-transaction…==”
• Response:

  {
    "status": "Success",
    "transactionId": "5x...solana-transaction-signature...",
    "slot": 299283763,
    "inputAmountResult": "1230000000",
    "outputAmountResult": "19950000",
    "swapEvents": [
      {
        "type": "swap",
        "inputMint": "So11111111111111111111111111111111111111112",
        "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "inAmount": "1230000000",
        "outAmount": "19950000"
      }
    ]
  }
  

License

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