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.11.tar.gz (18.1 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.11-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: traderouter_mcp-1.0.11.tar.gz
  • Upload date:
  • Size: 18.1 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.11.tar.gz
Algorithm Hash digest
SHA256 b5891a2b2dd0eeb9da5e08d80c1bda4ec1ca8da7c615ed0fe7e29c5b57fa2666
MD5 894de12e9685c00c3ccb33b1d03a51ef
BLAKE2b-256 e93a4e52759cf10c1cdfdd933d6c7892badf93cc490609ce47126d2fc6c8a1db

See more details on using hashes here.

File details

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

File metadata

  • Download URL: traderouter_mcp-1.0.11-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.11-py3-none-any.whl
Algorithm Hash digest
SHA256 443b498ca937b8b94c2f6ca6882aae95171b6ff8c90b88c41da8c16bff94c5e9
MD5 2e48097d5156f884e79ab597a03e4223
BLAKE2b-256 38357c8df03e09501108fdfec0d4d85645684d10ef2565d093467b120f844e1f

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