trade-router-mcp — Claude Code MCP server: features and setup
Non-custodial Solana trading engine for AI agents. It executes swaps, limit orders, and TWAP strategies while keeping private keys on your machine.
claude mcp add --env TRADEROUTER_PRIVATE_KEY=<TRADEROUTER_PRIVATE_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env TRADEROUTER_SERVER_PUBKEY=<TRADEROUTER_SERVER_PUBKEY> --env TRADEROUTER_SERVER_PUBKEY_NEXT=<TRADEROUTER_SERVER_PUBKEY_NEXT> --env TRADEROUTER_REQUIRE_SERVER_SIGNATURE=<TRADEROUTER_REQUIRE_SERVER_SIGNATURE> --transport stdio trade-router-mcp -- npx -y @traderouter/trade-router-mcpWhat trade-router-mcp does
This server connects an AI assistant to Solana decentralized exchanges. An agent can read wallet balances, check token market caps, perform instant token swaps, or schedule automated orders. It supports limit prices and time-weighted average price schedules.
Private key safety relies on local signing. The process reads TRADEROUTER_PRIVATE_KEY from the environment without sharing it over the network. When an agent requests a swap, the API generates an unsigned payload, the local process signs it with @solana/web3.js, and the signed bundle goes to Jito for MEV protection.
Running the server requires Node.js 18 or newer and a base58 private key. A dedicated trading wallet is recommended over using cold storage funds. The service charges a flat 1% fee on swap volume inside the protection route, while read-only requests carry no charge.
What it helps with
- swap Solana tokens across liquidity pools directly from an agent
- place limit and trailing stop orders without exposing private keys
- inspect token holdings and track order execution logs
- submit transactions through Jito bundles to prevent MEV frontrunning
Example prompts for the agent
- Check my current token balances using
get_holdings - Swap USDC for SOL using the
auto_swaptool - Place a limit buy order for this token using
place_limit_order
How to install trade-router-mcp
Platform CLI
claude mcp add --env TRADEROUTER_PRIVATE_KEY=<TRADEROUTER_PRIVATE_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env TRADEROUTER_SERVER_PUBKEY=<TRADEROUTER_SERVER_PUBKEY> --env TRADEROUTER_SERVER_PUBKEY_NEXT=<TRADEROUTER_SERVER_PUBKEY_NEXT> --env TRADEROUTER_REQUIRE_SERVER_SIGNATURE=<TRADEROUTER_REQUIRE_SERVER_SIGNATURE> --transport stdio trade-router-mcp -- npx -y @traderouter/trade-router-mcpReplace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
codex mcp add trade-router-mcp --env TRADEROUTER_PRIVATE_KEY=<TRADEROUTER_PRIVATE_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env TRADEROUTER_SERVER_PUBKEY=<TRADEROUTER_SERVER_PUBKEY> --env TRADEROUTER_SERVER_PUBKEY_NEXT=<TRADEROUTER_SERVER_PUBKEY_NEXT> --env TRADEROUTER_REQUIRE_SERVER_SIGNATURE=<TRADEROUTER_REQUIRE_SERVER_SIGNATURE> -- npx -y @traderouter/trade-router-mcpReplace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"mcpServers": {
"trade-router-mcp": {
"command": "npx",
"args": [
"-y",
"@traderouter/trade-router-mcp"
],
"env": {
"TRADEROUTER_PRIVATE_KEY": "<TRADEROUTER_PRIVATE_KEY>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"TRADEROUTER_SERVER_PUBKEY": "<TRADEROUTER_SERVER_PUBKEY>",
"TRADEROUTER_SERVER_PUBKEY_NEXT": "<TRADEROUTER_SERVER_PUBKEY_NEXT>",
"TRADEROUTER_REQUIRE_SERVER_SIGNATURE": "<TRADEROUTER_REQUIRE_SERVER_SIGNATURE>"
}
}
}
}Replace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"servers": {
"trade-router-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@traderouter/trade-router-mcp"
],
"env": {
"TRADEROUTER_PRIVATE_KEY": "<TRADEROUTER_PRIVATE_KEY>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"TRADEROUTER_SERVER_PUBKEY": "<TRADEROUTER_SERVER_PUBKEY>",
"TRADEROUTER_SERVER_PUBKEY_NEXT": "<TRADEROUTER_SERVER_PUBKEY_NEXT>",
"TRADEROUTER_REQUIRE_SERVER_SIGNATURE": "<TRADEROUTER_REQUIRE_SERVER_SIGNATURE>"
}
}
}
}Replace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
gemini mcp add -e TRADEROUTER_PRIVATE_KEY=<TRADEROUTER_PRIVATE_KEY> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e TRADEROUTER_SERVER_PUBKEY=<TRADEROUTER_SERVER_PUBKEY> -e TRADEROUTER_SERVER_PUBKEY_NEXT=<TRADEROUTER_SERVER_PUBKEY_NEXT> -e TRADEROUTER_REQUIRE_SERVER_SIGNATURE=<TRADEROUTER_REQUIRE_SERVER_SIGNATURE> trade-router-mcp npx -y @traderouter/trade-router-mcpReplace <…> with your own values. 2 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about trade-router-mcp
How do I install trade-router-mcp in Claude Code?
Run claude mcp add trade-router-mcp -e TRADEROUTER_PRIVATE_KEY=<TRADEROUTER_PRIVATE_KEY> -- npx -y @traderouter/trade-router-mcp.
What does trade-router-mcp do?
It gives your AI agent tools to trade on Solana, query token market caps, and place automated limit or TWAP orders.
Does the server expose my private key?
No. The key remains on your local machine to sign transactions via @solana/web3.js, and only signed payloads are sent to the network.
