Jupiter MCP Server

Jupiter MCP Server

Solana token swap execution via Jupiter's Ultra API using MCP.

21
Stars
10
Forks
21
Watchers
4
Issues
Jupiter MCP Server enables the execution of token swaps on the Solana blockchain through Jupiter’s Ultra API, integrating DEX routing and RFQ for optimal pricing. It fetches swap orders and executes transactions, handling slippage, priority fees, and transaction confirmations. The system is designed to operate within the Model Context Protocol, exposing tool interfaces for structured input and output. Node.js 18+ and access to a Solana wallet and RPC node are required.

Key Features

Fetches swap orders with optimal price routing
Executes swaps via Jupiter’s Ultra API
Handles slippage and priority fee management
Supports Solana wallet private key integration
Works with customizable Solana RPC endpoints
Exposes tools with standardized inputs/outputs
Compatible with Model Context Protocol setups
JSON-based tool interface
Comprehensive swap event reporting
Installation via simple npm setup

Use Cases

Automated Solana token swap execution for trading bots
Integration with agent platforms for on-chain swaps
Implementing optimal DEX routing strategies for DeFi applications
Providing secure and streamlined wallet-based swap services
RFQ-enabled price comparison for token trades
Programmatic access to Jupiter Ultra API for advanced traders
Building managed liquidity routing agents
Developing model-driven or conversational swap assistants
Enabling natural language interfaces for crypto transactions
Contextual orchestration in decentralized finance operations

README

Jupiter MCP Server

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

License Node.js Status

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:

    bash
    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:

    bash
    npm install
    
  3. Client Configuration:

json
{
  "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.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language JavaScript
Default Branch main
Size 27 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • PumpSwap MCP Server

    PumpSwap MCP Server

    MCP server for real-time Solana token trades and pool data.

    PumpSwap MCP Server allows AI agents to interact with the PumpSwap DEX on Solana for automated, real-time token swaps and on-chain trading operations. It exposes commands for buying and selling tokens, querying token prices, and retrieving liquidity pool information. Designed for secure integration with Solana accounts, it enables customizable slippage and transaction fees while supporting context-driven, AI-issued commands. The server operates as a bridge between AI agents and the PumpSwap protocol, facilitating seamless trading and data queries.

    • 5
    • MCP
    • kukapay/pumpswap-mcp
  • Sui Trader MCP

    Sui Trader MCP

    MCP server enabling automated token swaps on the Sui blockchain.

    Sui Trader MCP acts as an MCP server designed for AI agents to conduct optimal token swaps on the Sui blockchain. It integrates with the Cetus Aggregator to execute swaps on the Sui mainnet, utilizing secure Bech32 private key management. The tool supports configuration for MCP-compatible clients, allowing seamless invocation of swap operations. Built with Node.js, it provides a reliable interface between AI-driven applications and blockchain-based token swap functionality.

    • 4
    • MCP
    • kukapay/sui-trader-mcp
  • Uniswap Trader MCP

    Uniswap Trader MCP

    Automate token swaps on Uniswap across multiple blockchains for AI agents.

    Uniswap Trader MCP provides an MCP server interface enabling AI agents to automate token swaps on Uniswap V3 across several EVM-compatible blockchains. It offers real-time price quoting, optimized trade route suggestions, and direct execution of swaps with configurable slippage and deadlines. Multi-chain support allows seamless integration with networks such as Ethereum, Polygon, Arbitrum, and others for robust DeFi trading automation.

    • 34
    • MCP
    • kukapay/uniswap-trader-mcp
  • Uniswap V3 Price MCP Server

    Uniswap V3 Price MCP Server

    Real-time Uniswap V3 token price server for AI agents and DeFi automation.

    Uniswap V3 Price MCP Server delivers real-time token prices from Uniswap V3 across major EVM-compatible networks, including Ethereum, Polygon, Arbitrum, and Optimism. Optimized for AI agents and DeFi automation, it queries token prices in USD or other stablecoins, with optional conversion via CryptoCompare. The server is designed for compatibility with MCP clients, enabling seamless and standardized integrations. Environment setup is straightforward, leveraging Infura endpoints and Node.js.

    • 2
    • MCP
    • kukapay/uniswap-price-mcp
  • solscan-mcp

    solscan-mcp

    A Rust-based MCP server for querying Solscan Pro API on Solana blockchain data.

    solscan-mcp provides a Model Context Protocol (MCP) server that interfaces with the Solscan Pro API to deliver blockchain data from the Solana network. Built in Rust, it allows querying of token information, account activities, and transactions, and is designed for easy integration with language models. The tool supports context-driven investigations by leveraging AI to analyze and report on blockchain wallet behaviors using customized context inputs.

    • 32
    • MCP
    • wowinter13/solscan-mcp
  • MCP XRPL Server

    MCP XRPL Server

    Unified Model Context Protocol server for seamless AI-driven interaction with the XRP Ledger.

    MCP XRPL Server provides a comprehensive Model Context Protocol implementation for the XRP Ledger, enabling AI agents to access blockchain services seamlessly across MainNet, TestNet, and DevNet. It offers an extensive suite of features including account management, token transfers, NFT operations, DIDs, AMM operations, and oracle interactions, all via a standardized MCP interface. The server supports context-driven interactions, making XRPL functionality readily accessible for AI-powered agents.

    • 5
    • MCP
    • RomThpt/mcp-xrpl
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results