TrenchersAIDocs

Trade with AI

Agent API

Run your bots from Claude, ChatGPT, Cursor and other AI apps.

The Agent API is an MCP server. Connect an AI app to it, and the app can read and run your bots and ask the Trenchers assistant for you.

Connect an app

  1. Open Agent API

    Open your account menu and pick Agent API. If you do not see it, the Agent API is not on for your account yet.

  2. Pick your app

    Under One-click apps, Claude opens with Trenchers filled in, and ChatGPT, Grok, Gemini and Le Chat show a few short steps. Under Developer tools, Cursor and VS Code open an install link.

  3. Sign in to Trenchers

    Known apps connect straight away. Any other app asks you to Allow access or Deny.

The server address is https://mcp.trenchers.ai/mcp. From a terminal:

claude mcp add --transport http trenchers https://mcp.trenchers.ai/mcp
codex mcp add trenchers --url https://mcp.trenchers.ai/mcp
gemini mcp add --transport http trenchers https://mcp.trenchers.ai/mcp

Then sign in: in Claude Code, run /mcp and choose Authenticate; for Codex, run codex mcp login trenchers.

Scripts, Windsurf and Cline cannot sign in, so they need an API key (a personal access token). Create one under Advanced: API key, or in Settings → Connected apps, where you pick its permissions and an expiry of up to 90 days. It is shown once, and anyone holding it can act for you.

Permissions

PermissionWhat the app can do
AccountSee who you are, your limits and what is enabled.
Read botsSee your bots, positions, trades, performance and settings.
Paper botsCreate paper bots, and change, start, pause or archive them.
Live botsThe same on live bots, and move SOL in and out of their wallets. Needs live trading on your account.
PortfolioSee your holdings and realized PnL.
AI assistantAsk the assistant for you. This counts toward your AI limits.

Signing in, and keys from the Agent API page, grant every permission your account allows. No connection can reach your wallet keys, your login or your account settings, place manual swaps, or create a live bot.

Live actions use real money, and a paused bot stops managing its open positions. Trenchers can ask you to approve a live action in the app; the agent then shows you a link.

Every change a connected app makes, live actions included, is listed under Recent activity in Settings → Connected apps.

Limits and revoking

Each connection can make 120 reads and 30 changes a minute. Across all connections, your account allows 10 live actions and 6 assistant questions a minute.

To cut an app off, revoke it under Your connections on the Agent API page, or in Settings → Connected apps. It stops working within 15 seconds.