Jupiter MCP Server

This repository contains a Model Context Protocol (MCP) server that provides Claude with access to Jupiter's swap API. The server enables Claude to perform operations like getting quotes, building swap transactions, and sending swap transactions on the Solana blockchain using Jupiter.

Overview

The MCP server exposes several tools to Claude:

jupiter_get_quote: Get a quote for swapping tokens on Jupiter
jupiter_build_swap_transaction: Build a swap transaction on Jupiter
jupiter_send_swap_transaction: Send a swap transaction on Jupiter
jupiter_execute_swap: Execute a complete swap using a wallet private key from environment variables

API Implementation

This server uses Jupiter APIs:

Lite API v1 (https://lite-api.jup.ag/swap/v1) for executing swaps

The Lite API provides a simplified interface for building and executing swaps in a single request, which improves reliability.

Prerequisites

Node.js (v16 or higher)
Claude Desktop application
(Optional) A Solana wallet private key for automatic swap execution

Installation

From npm (recommended)

# Install globally
npm install -g jupiter-mcp-server

# Or use with npx
npx jupiter-mcp-server

From source

Clone this repository:

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

Install dependencies:
```
npm ci
```
Build the project:
```
npm run build
```
Install globally (optional):
```
npm install -g ./
```

Configuration

Configure Claude Desktop with Environment Variables

To configure Claude Desktop to use this MCP server with environment variables for automatic swap execution:

Open Claude Desktop
Navigate to the Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\\Claude\\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Add the MCP server configuration with environment variables:

{
  "mcpServers": {
    "jupiter-mcp-server": {
      "command": "npx",
      "args": ["jupiter-mcp-server"],
      "env": {
        "SOLANA_PRIVATE_KEY": "your_private_key_in_base58_format",
        "SOLANA_RPC_ENDPOINT": "https://api.mainnet-beta.solana.com",
        "SOLANA_NETWORK": "mainnet-beta",
        "LOG_LEVEL": "info"
      }
    }
  }
}

If you've installed from source and want to run the local version, use:

{
  "mcpServers": {
    "jupiter-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/your/jupiter-mcp-server/build/index.js"
      ],
      "env": {
        "SOLANA_PRIVATE_KEY": "your_private_key_in_base58_format",
        "SOLANA_RPC_ENDPOINT": "https://api.mainnet-beta.solana.com",
        "SOLANA_NETWORK": "mainnet-beta",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Environment Variables Description

SOLANA_PRIVATE_KEY (required for automatic swap): Your Solana wallet private key in base58 format
SOLANA_RPC_ENDPOINT (optional): RPC endpoint URL, defaults to mainnet public endpoint
SOLANA_NETWORK (optional): 'mainnet-beta', 'testnet', or 'devnet', defaults to 'mainnet-beta'
LOG_LEVEL (optional): 'error', 'warn', 'info', or 'debug', defaults to 'info'

Alternative: Using a .env File

If you're running the server directly (not through Claude Desktop), you can create a .env file in the root directory with the same variables:

SOLANA_PRIVATE_KEY=your_private_key_in_base58_format
SOLANA_RPC_ENDPOINT=https://api.mainnet-beta.solana.com
SOLANA_NETWORK=mainnet-beta
LOG_LEVEL=info

Running Locally

# If installed globally
jupiter-mcp-server

# If installed from source
node build/index.js

# Using npx
npx jupiter-mcp-server

Usage

Once configured, restart Claude Desktop. Claude will now have access to the Jupiter swap tools. You can ask Claude to:

Get a quote for swapping tokens:

What's the quote for swapping 1 SOL to USDC?

Build a swap transaction:

Build a swap transaction for the quote I just got.

Send a swap transaction:

Send the swap transaction I just built.

Execute a swap automatically (if you've provided a private key):
```
Execute a swap of 0.1 SOL to USDC.
```

Automatic Swap Execution

If you've configured your environment with a Solana private key, Claude can now execute swaps directly without requiring you to sign transactions manually. This feature uses the private key from your environment to:

Get a quote for the swap
Build the transaction
Sign the transaction with your private key
Send the transaction to the network

All in one step!

Troubleshooting

If you encounter errors during swap execution:

Set LOG_LEVEL=debug in your environment variables to get detailed logs
Check that you have provided a valid Solana private key
Ensure your wallet has sufficient SOL for the swap and transaction fees
Verify that you are using the correct input and output token mints

Development

Adding New Tools

To add new tools to the MCP server:

Define the tool in src/tools.ts
Create a handler function in the appropriate handler file
Add the handler to the handlers object in src/tools.ts

Building

npm run build

Testing

npm test

Publishing to npm

Make sure you're logged in to npm:

npm login

Then publish the package:

npm publish

To publish a new version, first update the version in package.json:

npm version patch  # or minor, or major
npm publish

License

MIT