Jupiter Solana MCP Server

A comprehensive MCP (Model Context Protocol) server for interacting with Jupiter Protocol on Solana. Features token swaps, search, portfolio management, and intelligent error diagnostics.

- Token Swaps: Execute swaps via Jupiter's Ultra API with intelligent slippage and fee handling
- Token Search: Find tokens by symbol, name, or mint address with detailed market data
- Portfolio Management: View token balances and holdings across your wallet
- Smart Diagnostics: Intelligent error detection with helpful user guidance
- SOL Fee Checking: Automatic validation of sufficient SOL for transaction fees
- Multi-language Support: Full English localization for international users

- Node.js: Version 18 or higher (for nativefetchsupport)
- Jupiter API Key: Get your free API key atJupiter Portal
- 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)

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

SOLANA_RPC_URL=https://api.mainnet-beta.solana.com PRIVATE_KEY=your_base58_encoded_private_key_here JUPITER_API_KEY=your_jupiter_api_key_here

{ "mcpServers": { "Jupiter-MCP": { "command": "node", "args": ["path/to/jupiter-mcp/index.js"], "env": { "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com", "PRIVATE_KEY": "your_base58_encoded_private_key_here", "JUPITER_API_KEY": "your_jupiter_api_key_here" } } } }

Search for tokens by symbol, name, or mint address with detailed market information.

- query: Token symbol (SOL, USDC), name (Solana), or mint address

Returns: Comprehensive token data including:

- Price and 24h change percentage
- Trading volume and liquidity metrics
- Security audit (mint/freeze authority status)
- Organic score and verification status
- Holder count and market cap

Get token balances for any wallet address with automatic token identification.

- walletAddress(optional): Wallet to check (defaults to configured wallet)
- mints(optional): Specific token mints to check

Returns: Complete portfolio overview including SOL and all SPL tokens with UI-friendly amounts.

Fetch optimized swap orders from Jupiter's Ultra API combining DEX routing and RFQ.

- inputMint: Input token mint address
- outputMint: Output token mint address
- amount: Input amount as string (e.g., "1.23")
- slippageBps: Slippage tolerance in basis points (e.g., 50 for 0.5%)

Returns: Swap order withrequestId,transaction, amounts, and calculated exchange rates.

Execute swap transactions with intelligent error handling and status monitoring.

- requestId: Order ID fromget-ultra-order
- transaction: Base64-encoded transaction

Returns: Execution results with transaction signature, Solscan links, and detailed status.

- ✅ Pre-flight SOL balance checking
- 🔄 Automatic transaction status polling (up to 2 minutes)
- 🧠 Intelligent error analysis with helpful suggestions
- 🔗 Direct Solscan transaction links

{ "tool": "search-token", "arguments": { "query": "BONK" } }

Response: Detailed token information including price, volume, security audit, and holder count.

{ "tool": "get-balances", "arguments": {} }

Response: Complete wallet overview with SOL and all SPL token balances in user-friendly format.

{ "tool": "get-ultra-order", "arguments": { "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": "0.1", "slippageBps": 50 } }

{ "tool": "execute-ultra-order", "arguments": { "requestId": "uuid-from-step-1", "transaction": "base64-encoded-transaction-from-step-1" } }

The server provides intelligent error detection and user-friendly messages:

- Insufficient SOL: "❌ Insufficient SOL for transaction fees. Add 0.01 SOL (~$1.25) to your wallet"
- Slippage Issues: "⚠️ Slippage tolerance exceeded. Try increasing slippage or retry after some time"
- Network Problems: "🔄 Transaction status determination timeout. You can try again with the same order"

- Check yourJUPITER_API_KEYin environment variables
- Verify your API key atJupiter Portal

This project is licensed under the MIT License. See theLICENSEfile for details.
- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

- Issues:GitHub Issues
- Jupiter Docs:Jupiter Developer Documentation
- Solana Docs:Solana Developer Documentation

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.