Skip to main content

TradeRouter.ai MCP Server — Non-custodial Solana swap & limit order engine for AI agents

Project description

TradeRouter MCP (Python)

mcp-name: io.github.re-bruce-wayne/trade-router-mcp

License: MIT Security: non-custodial PyPI

Non-custodial Solana trading API for AI agents. One integration replaces Jupiter + Helius + Jito + custom limit-order code. Your private key never leaves the local process — only signed transactions are transmitted to api.traderouter.ai.

See SECURITY.md for the full threat model and data-flow diagram.

Install

Run directly without installing (recommended):

{
  "traderouter": {
    "command": "uvx",
    "args": ["traderouter-mcp"],
    "env": {
      "TRADEROUTER_PRIVATE_KEY": "<your-solana-base58-private-key>"
    }
  }
}

Or install into a project:

uv add traderouter-mcp

Environment variables

Variable Default Purpose
TRADEROUTER_PRIVATE_KEY required for signing Solana base58-encoded private key. Used locally for signing, never transmitted.
TRADEROUTER_SERVER_PUBKEY hardcoded trust anchor Override the server public key used to verify order_filled events
TRADEROUTER_BASE_URL https://api.traderouter.ai Override API base (e.g. for staging)

Features

REST tools

  • swap — build an unsigned swap transaction (multi-DEX: Raydium, PumpSwap, Orca, Meteora)
  • protect — submit signed tx via Jito bundle, returns confirmed balance changes
  • holdings — most accurate wallet scan on Solana
  • mcap — market cap + price
  • flex — generate trade-card PNG

WebSocket order types

  • place_limit — limit order by mcap or price
  • place_trailing — trailing stop (percentage or absolute)
  • place_dca — dollar-cost averaging
  • place_twap — time-weighted average price
  • place_combo — limit + trailing + TWAP in one chain
  • check_order, list_orders, cancel_order, extend_order

Server monitors mcap ~every 5 seconds. When an order triggers, you receive a signed-tx-ready payload; the MCP signs it locally (using TRADEROUTER_PRIVATE_KEY) and submits to /protect automatically.

Non-custodial by construction

See SECURITY.md for the complete threat model. TL;DR:

  1. swap tool returns unsigned transaction
  2. MCP signs locally with TRADEROUTER_PRIVATE_KEY (held in local process memory)
  3. Signed transaction sent to api.traderouter.ai/protect
  4. Server submits to Jito bundle, returns confirmed balance changes
  5. Private key never touches the network

Links

License

MIT. See LICENSE.

Security disclosure

Email security@traderouter.ai or open a GitHub Security Advisory. See SECURITY.md for policy.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

traderouter_mcp-1.0.10.tar.gz (17.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

traderouter_mcp-1.0.10-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

File details

Details for the file traderouter_mcp-1.0.10.tar.gz.

File metadata

  • Download URL: traderouter_mcp-1.0.10.tar.gz
  • Upload date:
  • Size: 17.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for traderouter_mcp-1.0.10.tar.gz
Algorithm Hash digest
SHA256 1b6cff70d50bfb4042e1fe6110a92228ee01da24c54536b975694b9db09be8e8
MD5 d5a3dceb1af936141396e49b44ba0b08
BLAKE2b-256 bb1b7199cdf59c08bc9c3808bf75609800fdb6e8be5e90d4810a7c97ac023bd0

See more details on using hashes here.

File details

Details for the file traderouter_mcp-1.0.10-py3-none-any.whl.

File metadata

  • Download URL: traderouter_mcp-1.0.10-py3-none-any.whl
  • Upload date:
  • Size: 15.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for traderouter_mcp-1.0.10-py3-none-any.whl
Algorithm Hash digest
SHA256 067dd13d4f8ba1325f3890f72f9792333e7733f344d7f81c25c2a39077acf7ae
MD5 427e512802883e7022f7627677c05a1c
BLAKE2b-256 5aba2a9f56f2422f2e4731a86ec9c3c3127d1d13896f7bd918b81e2bc142dd33

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page