trade-router-mcp

A Model Context Protocol server for TradeRouter.ai — Solana swap & limit order engine.

Requirements

• Node.js >= 20.18.0
• A Solana wallet private key (base58)

Installation

npx @traderouter/trade-router-mcp

Claude Desktop Setup

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "traderouter": {
      "command": "npx",
      "args": ["-y", "@traderouter/trade-router-mcp"],
      "env": {
        "TRADEROUTER_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

| OS | Config path | |---------|----------------------------------------------------------------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

Environment Variables

| Variable | Required | Description | |---|---|---| | TRADEROUTER_PRIVATE_KEY | ✅ | Solana wallet private key in base58 format | | SOLANA_RPC_URL | ❌ | RPC endpoint. Defaults to https://api.mainnet-beta.solana.com | | TRADEROUTER_SERVER_PUBKEY | ❌ | Server public key for signature verification | | TRADEROUTER_SERVER_PUBKEY_NEXT | ❌ | Next server public key for key rotation | | TRADEROUTER_REQUIRE_SERVER_SIGNATURE | ❌ | Verify server signatures on fills. Defaults to true | | TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE | ❌ | Verify server signatures on order creation. Defaults to true |

Available Tools

| Tool | Description | |---|---| | get_wallet_address | Get the configured wallet address | | build_swap | Build an unsigned swap transaction | | submit_signed_swap | Submit a manually signed transaction | | auto_swap | Build and auto-sign a swap in one step | | get_holdings | Get token holdings for a wallet | | get_mcap | Get market cap and price data for token(s) | | get_flex_card | Get flex trade card PNG URL for wallet and token | | place_limit_order | Place a limit buy or sell order | | place_trailing_order | Place a trailing buy or sell order | | place_twap_order | Place a TWAP (time-weighted) buy or sell order | | place_limit_twap_order | Place a limit-then-TWAP order (limit target then TWAP execution) | | place_trailing_twap_order | Place a trailing-then-TWAP order (trail trigger then TWAP execution) | | place_limit_trailing_order | Place a limit-then-trailing order (limit then trailing, single swap on trigger) | | place_limit_trailing_twap_order | Place a limit-then-trailing-then-TWAP order | | list_orders | List all active orders for a wallet | | check_order | Check the status of an order | | cancel_order | Cancel an active order | | extend_order | Extend an order's expiry | | connect_websocket | Connect and register WebSocket for a wallet | | connection_status | Get current WebSocket connection status | | get_fill_log | Get log of filled orders |