Trading MCP
Connect an AI client to Nunchi's hosted trading tools through Model Context Protocol (MCP). Use read-only access to inspect portfolio, market, strategy, and status data. Trading requests depend on the permission tier you grant.
If you need connection or authentication details, request access. Start with the read_only tier.
Client Setup
Use the hosted endpoint:
https://agent.nunchi.trade/mcp/trading
Choose your client. Use the scoped token associated with your access when authentication is required.
- Claude Code
- Claude Desktop
- ChatGPT
- Codex
- Codex CLI
- Cursor
- Grok
claude mcp add nunchi-trading --transport http https://agent.nunchi.trade/mcp/trading
Enter /mcp, select nunchi-trading, and authenticate with your scoped token.
- Open Settings → Connectors.
- Add a custom connector using the endpoint above.
- Authenticate with your scoped token.
- Turn on Developer Mode.
- Open Settings → Apps.
- Create an app and add the endpoint above.
- Open Settings → MCP servers.
- Select Streamable HTTP.
- Add the endpoint above.
codex mcp add nunchi-trading --url https://agent.nunchi.trade/mcp/trading
Enter /mcp and select nunchi-trading.
- Open Settings → Cursor Settings.
- Select Tools & MCPs.
- Connect using the endpoint above.
- Start a chat and select + → Add connector.
- Choose Custom.
- Add the endpoint above.
Permission Tiers
| Tier | Intended use | Trading access |
|---|---|---|
read_only | Portfolio, market, strategy, and status inspection | None |
testnet_trading | Testnet strategy runs and order requests | Testnet only |
live_trading | Mainnet trading workflows | Requires explicit mainnet and write-tool consent |
The hosted runner does not handle your private keys. Revoke or regenerate tokens when permissions change or when an agent no longer needs access.
Risks
You remain responsible for every order your AI agent places. If you authorize an agent to act without asking for approval, it may submit trades without a separate confirmation prompt.
Before enabling live trading, read the Agentic Trading Beta Disclosures.