Add Trade Router — non-custodial Solana swap MCP + skill#153
Add Trade Router — non-custodial Solana swap MCP + skill#153re-bruce-wayne wants to merge 2 commits into
Conversation
Two entries: 1. DeFi (AI Coding Skills): trade-router-skill — points to the SKILL.md in openclaw-skills/trade-router/ with the full API reference for non-custodial Solana swaps + limit/trailing/TWAP/combo orders. 2. Developer Tools: trade-router-mcp — the npm-published MCP server (@traderouter/trade-router-mcp) wrapping the same API for use in Claude Desktop, Cursor, Cline, and any MCP-compatible client. The skill exists as a Claude Code / OpenClaw spec; the MCP server is a ready-to-install runtime for the same API. Both are MIT licensed. Notable properties: - Multi-DEX routing across Raydium, PumpSwap, Orca, Meteora (vs the single-DEX/Jupiter-only entries already in this list) - 11 order types including 4 combo permutations (limit+trailing+TWAP) - Jito MEV-protected execution via /protect - Ed25519-verified server messages with hardcoded trust anchor + rotation slot (TRADEROUTER_SERVER_PUBKEY_NEXT) - TRADEROUTER_DRY_RUN env var for safe agent testing - Non-custodial: private key never leaves the agent process Sister listings: io.github.TradeRouter/trade-router-mcp + ai.traderouter/trade-router-mcp on the MCP Registry, glama.ai listing, awesome-mcp-servers PR #5345. VirusTotal scan on v1.0.10 tarball: 0/62 detections. CI green: github.com/TradeRouter/trade-router-mcp/actions
Greptile SummaryThis PR adds two entries to the curated list:
Confidence Score: 3/5Mergeable after addressing the personal fork link; formatting issues are minor but the link durability concern should be resolved first. One P1 finding (skill URL points to a personal GitHub fork rather than a stable canonical source, risking a broken link) plus two P2 style issues (missing blank lines before section headers, out-of-alphabetical-order placement) bring the score below 4. README.md — specifically the trade-router-skill URL on line 51 and the formatting around both new entries. Important Files Changed
Sequence DiagramsequenceDiagram
participant Agent as AI Agent
participant MCP as trade-router-mcp
participant API as Trade Router API
participant DEX as DEX (Raydium/Orca/etc.)
participant Jito as Jito Bundle
Agent->>MCP: swap / limit / TWAP tool call
MCP->>API: POST /quote (multi-DEX routing)
API-->>MCP: best route + unsigned tx
MCP-->>Agent: unsigned transaction
Agent->>Agent: sign tx with local keypair
Agent->>MCP: submit signed tx
MCP->>API: POST /protect (Jito bundle)
API->>Jito: MEV-protected bundle
Jito->>DEX: execute swap
DEX-->>Agent: confirmation
Reviews (1): Last reviewed commit: "Add Trade Router (skill + MCP server)" | Re-trigger Greptile |
| - [pnp-markets-skill](https://github.com/pnp-protocol/solana-skill) - AI coding skill for PNP Protocol covering permissionless prediction markets on Solana with V2 AMM, P2P betting, custom oracle settlement, and social media-linked markets. | ||
| - [Sentients](https://github.com/koshmade/sentients.wtf) - AI agents minting unique inscriptions on Solana. First AI Agent-Native Protocol with autonomous wallets and deterministic art generated from blockchain entropy. | ||
|
|
||
| - [trade-router-skill](https://github.com/re-bruce-wayne/openclaw-skills/tree/main/trade-router) - AI coding skill for Trade Router covering non-custodial Solana swaps with multi-DEX routing across Raydium, PumpSwap, Orca, and Meteora, Jito MEV-protected execution via /protect, and limit/trailing/TWAP/combo orders over WebSocket. The agent signs locally; the API never holds keys. |
There was a problem hiding this comment.
Skill links to a personal GitHub fork
The trade-router-skill URL (github.com/re-bruce-wayne/openclaw-skills/…) points to the PR author's personal account rather than a canonical org repository. If the fork is renamed, deleted, or the branch changes, the link silently breaks. Every other DeFi skill in this section resolves to an organization or official repo (e.g., sendaifun/skills, jup-ag/agent-skills, pnp-protocol/solana-skill). The PR description mentions this skill is "live on ClawHub" — if there's a stable upstream URL (e.g., a ClawHub raw URL or a TradeRouter/ org repo), that would be a more durable canonical link.
| - [trade-router-skill](https://github.com/re-bruce-wayne/openclaw-skills/tree/main/trade-router) - AI coding skill for Trade Router covering non-custodial Solana swaps with multi-DEX routing across Raydium, PumpSwap, Orca, and Meteora, Jito MEV-protected execution via /protect, and limit/trailing/TWAP/combo orders over WebSocket. The agent signs locally; the API never holds keys. | ||
| ### Infrastructure |
There was a problem hiding this comment.
Missing blank line before section header
There is no blank line between the new entry and ### Infrastructure, breaking the visual spacing that every other section transition uses in this file.
| - [trade-router-skill](https://github.com/re-bruce-wayne/openclaw-skills/tree/main/trade-router) - AI coding skill for Trade Router covering non-custodial Solana swaps with multi-DEX routing across Raydium, PumpSwap, Orca, and Meteora, Jito MEV-protected execution via /protect, and limit/trailing/TWAP/combo orders over WebSocket. The agent signs locally; the API never holds keys. | |
| ### Infrastructure | |
| - [trade-router-skill](https://github.com/re-bruce-wayne/openclaw-skills/tree/main/trade-router) - AI coding skill for Trade Router covering non-custodial Solana swaps with multi-DEX routing across Raydium, PumpSwap, Orca, and Meteora, Jito MEV-protected execution via /protect, and limit/trailing/TWAP/combo orders over WebSocket. The agent signs locally; the API never holds keys. | |
| ### Infrastructure |
Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!
| - [Sentients](https://github.com/koshmade/sentients.wtf) - AI agents minting unique inscriptions on Solana. First AI Agent-Native Protocol with autonomous wallets and deterministic art generated from blockchain entropy. | ||
|
|
||
| - [trade-router-skill](https://github.com/re-bruce-wayne/openclaw-skills/tree/main/trade-router) - AI coding skill for Trade Router covering non-custodial Solana swaps with multi-DEX routing across Raydium, PumpSwap, Orca, and Meteora, Jito MEV-protected execution via /protect, and limit/trailing/TWAP/combo orders over WebSocket. The agent signs locally; the API never holds keys. | ||
| ### Infrastructure |
There was a problem hiding this comment.
Entries placed out of alphabetical order with an extra blank line separator
Both additions are appended at the end of their respective sections after an extra blank line (breaking the list visually), rather than being inserted in alphabetical order inline. The DeFi list runs alphabetically from clawpump-arbitrage-skill through sanctum-skill, then pnp-markets-skill and Sentients appear out of order, and trade-router-skill is appended after another blank line. trade-router-mcp has the same pattern in Developer Tools. Inserting in alphabetical position and removing the extra blank line would match the existing formatting convention.
| - [trade-router-mcp](https://www.npmjs.com/package/@traderouter/trade-router-mcp) - Non-custodial Solana swap & limit-order MCP server for AI agents. 21 tools: swap, limit, trailing, TWAP, DCA, and combo orders (limit+trailing+TWAP) across Raydium, PumpSwap, Orca, and Meteora. Jito MEV-protected, Ed25519 server-message verification, `TRADEROUTER_DRY_RUN` for safe testing. Install: `npx -y @traderouter/trade-router-mcp`. | ||
| ## Learning Resources |
There was a problem hiding this comment.
Per review on PR solana-foundation#153: 1. Move trade-router-skill from end-of-DeFi (after Sentients with extra blank line above) into its alphabetical position right after sanctum-skill (s < t < trailing entries). Removes the visual break the appended placement created and matches the alphabetical run from clawpump-arbitrage-skill through sanctum-skill. 2. Add the blank line before ### Infrastructure that the appended placement was missing — now restored as a side effect of moving the entry up (the section break preserves Sentients's existing trailing blank line). 3. Add the blank line between trade-router-mcp and ## Learning Resources in Developer Tools to match the formatting convention every other section transition uses.
|
Thanks for the careful review — all three nits addressed in the latest commit:
Diff is rendered at the PR. Happy to make any further tweaks. |
What
Adds two entries:
trade-router-skill— points to the SKILL.md inopenclaw-skills/trade-router/(the same SKILL.md that's live on ClawHub).trade-router-mcp— the npm-published MCP server@traderouter/trade-router-mcpwrapping the same API for use in Claude Desktop, Cursor, Cline, and any MCP-compatible client.What's distinctive vs other DeFi entries already in this list
Most entries currently use a single DEX (Jupiter most often). Trade Router differentiates on:
/protectJito bundlesTRADEROUTER_SERVER_PUBKEY_NEXT)TRADEROUTER_DRY_RUNenv var lets agents drive the full flow with no live tx — every write tool short-circuits to{ dry_run: true, ... }POST /swapreturns an unsigned tx, the agent signs locally, only the signed bundle goes to/protect. The private key never crosses the network. Full threat model in SECURITY.md.Verification
@traderouter/trade-router-mcp@1.0.10, MIT, signed publishtraderouter-mcp@1.0.10ai.traderouter/trade-router-mcp@1.0.10(isLatest: true)Both entries fit existing format conventions in their respective sections.