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

Uploaded Python 3

File details

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

File metadata

  • Download URL: traderouter_mcp-1.0.13.tar.gz
  • Upload date:
  • Size: 18.5 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.13.tar.gz
Algorithm Hash digest
SHA256 c8877b4d67f7425ff737de8422931a061d1898020a741cc7a61544cdae27b688
MD5 1ed8a1ed682bc79d5c1dbda7be28053b
BLAKE2b-256 fef6bacd20b136a6307eb1b7a09c1dd4c224920b0b1c65c16d53f284c6b5be72

See more details on using hashes here.

File details

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

File metadata

  • Download URL: traderouter_mcp-1.0.13-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.13-py3-none-any.whl
Algorithm Hash digest
SHA256 c88ed406baff7cf4260b06cdba923432d4fd79caf270e6546bd3c637274bf817
MD5 c472d72d182ac31b53597ac6b10c0f47
BLAKE2b-256 3cf5b5d1ff19a2a220c7691384edd4c1dd980fc8579f7cf872da73e0c983b29b

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