ai.traderouter/trade-router-mcp

Non-custodial Solana swap & limit order engine for AI agents.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @traderouter/trade-router-mcp

Claude Code

claude mcp add trade-router-mcp -e 'TRADEROUTER_PRIVATE_KEY=<your 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>' -e 'TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE=<TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE>' -e 'TRADEROUTER_DRY_RUN=<TRADEROUTER_DRY_RUN>' -- npx -y @traderouter/trade-router-mcp@1.0.13

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "trade-router-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@traderouter/trade-router-mcp@1.0.13"
            ],
            "env": {
                "TRADEROUTER_PRIVATE_KEY": "<your 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>",
                "TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE": "<TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE>",
                "TRADEROUTER_DRY_RUN": "<TRADEROUTER_DRY_RUN>"
            }
        }
    }
}

Environment variables

TRADEROUTER_PRIVATE_KEY required secret Solana base58-encoded private key. Local signing only, never transmitted. See SECURITY.md.
SOLANA_RPC_URL Optional RPC endpoint override (default https://api.mainnet-beta.solana.com).
TRADEROUTER_SERVER_PUBKEY Optional override for the server public key used to verify order_filled ed25519 signatures.
TRADEROUTER_SERVER_PUBKEY_NEXT Optional second server public key accepted during key rotation.
TRADEROUTER_REQUIRE_SERVER_SIGNATURE Default 'true'. Verify server signatures on order_filled / twap_execution.
TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE Default 'true'. Verify server signatures on order_created.
TRADEROUTER_DRY_RUN Default 'false'. When 'true', write-action tools (submit_signed_swap, auto_swap, place_*_order, cancel_order, extend_order) short-circuit and return { dry_run: true, ... } instead of calling the API. Read-only tools execute normally.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

@traderouter/trade-router-mcp
Is this safe?
Requirements
Install
Environment variables
Tools
REST endpoints (under the hood)
Trust anchor
Use with LangChain
Fees
Machine-readable specs (live on traderouter.ai)
Security disclosure
License
Changelog

@traderouter/trade-router-mcp

A Model Context Protocol server for TradeRouter.ai — non-custodial Solana swap, limit, trailing, DCA, TWAP, and combo-order engine for AI agents.

Is this safe?

Yes, and here's exactly why. The private key is read once from TRADEROUTER_PRIVATE_KEY, used for local signing with @solana/web3.js + tweetnacl, and never transmitted, logged, or persisted. Only signed transactions leave your machine. Server messages are Ed25519-verified against a hard-coded trust anchor. See SECURITY.md for the full threat model, data-flow diagram, and permissions manifest.

Signing flow:

Agent calls build_swap → MCP sends wallet address (public key) to api.traderouter.ai
API returns an unsigned transaction
MCP signs the tx locally using TRADEROUTER_PRIVATE_KEY
The signed transaction is submitted to /protect (Jito MEV-protected bundle)
Server confirms and returns balance changes. The private key never crosses the network.

Requirements

Node.js ≥ 18
A Solana wallet private key in base58 format (use a dedicated trading wallet, not your main holdings)

Install

npx -y @traderouter/trade-router-mcp

Or wire it into an MCP client (Claude Desktop, Cursor, Cline, etc.):

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

OS	Claude Desktop 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	Default	Purpose
`TRADEROUTER_PRIVATE_KEY`	✅	—	Solana wallet private key (base58). Local use only.
`SOLANA_RPC_URL`	❌	`https://api.mainnet-beta.solana.com`	Custom RPC for reads
`TRADEROUTER_SERVER_PUBKEY`	❌	baked-in trust anchor	Override the server's Ed25519 trust anchor
`TRADEROUTER_SERVER_PUBKEY_NEXT`	❌	(unset)	Accept messages signed by this key in addition to the primary (key rotation)
`TRADEROUTER_REQUIRE_SERVER_SIGNATURE`	❌	`true`	Verify server signatures on `order_filled` / `twap_execution`
`TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE`	❌	`true`	Verify server signatures on `order_created`
`TRADEROUTER_DRY_RUN`	❌	`false`	When `true`, every write-action tool (`submit_signed_swap`, `auto_swap`, `place_*_order`, `cancel_order`, `extend_order`) returns `{ dry_run: true, tool, args }` instead of calling the API. Read-only tools execute normally. Added in 1.0.9.

Tools

Tool	Purpose
`get_wallet_address`	Get the configured wallet's public address
`build_swap`	Build an unsigned swap transaction
`submit_signed_swap`	Submit a manually signed transaction
`auto_swap`	Build + sign + submit in one call
`get_holdings`	Get token holdings for a wallet
`get_mcap`	Market cap and price for a token
`get_flex_card`	Trade card PNG URL for wallet + token
`place_limit_order`	Limit buy/sell by price or market cap
`place_trailing_order`	Trailing stop buy/sell
`place_twap_order`	TWAP (time-weighted) buy/sell
`place_limit_twap_order`	Limit trigger → TWAP execution
`place_trailing_twap_order`	Trailing trigger → TWAP execution
`place_limit_trailing_order`	Limit trigger → trailing execution (single swap on trigger)
`place_limit_trailing_twap_order`	Limit trigger → trailing trigger → TWAP execution
`list_orders`	List active orders for a wallet
`check_order`	Get status of a specific order
`cancel_order`	Cancel an active order
`extend_order`	Extend an order's expiry
`connect_websocket`	Register a wallet over the persistent WebSocket
`connection_status`	Current WebSocket connection state
`get_fill_log`	Log of filled orders

REST endpoints (under the hood)

Endpoint	Purpose
`POST /swap`	Build unsigned swap (multi-DEX: Raydium, PumpSwap, Orca, Meteora)
`POST /protect`	Submit signed tx via Jito bundle — MEV-protected
`POST /holdings`	Wallet scan — catches tokens standard RPC misses
`GET /mcap`	Market cap + price
`GET /flex`	Trade card PNG generation
`wss://api.traderouter.ai/ws`	Persistent WebSocket for limits / trailing / DCA / TWAP / combo orders

Trust anchor

The baked-in server public key is EXX3nRzfDUvbjZSmxFzHDdiSYeGVP1EGr77iziFZ4Jd4. Every order_filled, order_created, and twap_execution message from the server is verified with Ed25519 before being treated as authoritative. See SECURITY.md for details and the rotation mechanism (TRADEROUTER_SERVER_PUBKEY_NEXT).

Use with LangChain

Any MCP server works in LangChain via the official adapter:

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "traderouter": {
        "command": "npx",
        "args": ["-y", "@traderouter/trade-router-mcp"],
        "transport": "stdio",
        "env": {"TRADEROUTER_PRIVATE_KEY": "<base58>"},
    },
})
tools = await client.get_tools()

Fees

Flat 1% fee on swap volume, embedded in routing at /protect. No subscription, no API key, no monthly minimums. Read-only endpoints (/holdings, /mcap) are free.

Machine-readable specs (live on traderouter.ai)

URL	Format	Purpose
https://traderouter.ai/openapi.json	OpenAPI 3.1 (JSON)	Canonical API contract — generate SDKs in any language
https://traderouter.ai/openapi.yaml	OpenAPI 3.1 (YAML)	Same spec, YAML format (regenerated from the JSON)
https://traderouter.ai/llms.txt	text	LLM-readable API guide (per llmstxt.org)
https://traderouter.ai/SKILL.md	markdown	Anthropic Agent Skills format — full implementation guide
https://traderouter.ai/SECURITY.md	markdown	Threat model + data-flow diagram + permissions manifest (mirrors ./SECURITY.md here)
https://traderouter.ai/CHANGELOG.md	markdown	Unified changelog across the API / MCP server / Site version tracks

Quick SDK generation:

# TypeScript
openapi-generator-cli generate -i https://traderouter.ai/openapi.yaml -g typescript-axios -o ./sdk-ts

# Python
openapi-generator-cli generate -i https://traderouter.ai/openapi.yaml -g python -o ./sdk-py

Security disclosure

Email security@traderouter.ai or use GitHub Security Advisories on this repo. 48-hour acknowledgement. See SECURITY.md (or the hosted version if you'd rather link to a stable URL).

License

MIT. See LICENSE.

Changelog

See CHANGELOG.md.

Frequently asked questions

What is ai.traderouter/trade-router-mcp?

Non-custodial Solana swap & limit order engine for AI agents.

How do I install ai.traderouter/trade-router-mcp?

It runs on your machine. In Claude Code: claude mcp add trade-router-mcp -e 'TRADEROUTER_PRIVATE_KEY=<your 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>' -e 'TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE=<TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE>' -e 'TRADEROUTER_DRY_RUN=<TRADEROUTER_DRY_RUN>' -- npx -y @traderouter/trade-router-mcp@1.0.13. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ai.traderouter/trade-router-mcp need an API key?

Yes. It expects TRADEROUTER_PRIVATE_KEY, which you set in its configuration.

Is ai.traderouter/trade-router-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ai.traderouter/trade-router-mcp?

It is published by TradeRouter. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: TradeRouter
Category: Finance and payments
Runs: Local
GitHub stars: ★ 3
License: MIT
Language: JavaScript
Last commit: Apr 28, 2026
Open issues: 2
Version: 1.0.13
Published: Apr 27, 2026

ai.traderouter/trade-router-mcp

Similar servers

Shinjuku Shield Private x402 payments on Solana: shield, pay, and unshield USDC under caps you set.
Zenfulfillment MCP by usefulapi Read Zenfulfillment orders and stock; import or cancel orders and mark returns done.
x402 Agent Hub Multichain onchain reads, token honeypot audits with swap sim, CFD/ICT data & lead doss...
CryptoKeyhole Read-only market and on-chain data for Bitcoin, Ethereum and more; on-chain from our ow...
Glue Up MCP by usefulapi Read Glue Up events, memberships, contacts, organizations and finance records.
XRPL-Utilities XRPL data tools for AI agents: wallet classifier, signals, RWA tracker, ETF flows. Pay ...
Tillhub MCP by usefulapi Read Tillhub products, stock, transactions, customers and retail reports from your AI a...
ru-marketplace-mcp Read-only MCP servers for Russian marketplaces: prices, stock, ratings, reviews, seller...

Finance and payments