How to trade on Eterna with an AI agent (MCP guide)

The agent stack in one picture

Quick start

1. Create and fund the master account

   Sign up via ehx.app/r/Steve (code Steve, no KYC), connect your wallet, and deposit the collateral the agent will trade. The master account keeps custody; the agent only ever sees a sub-account.

2. Point an MCP client at the endpoint

   Add https://mcp.eterna.exchange/mcp as a remote MCP server. This works today with Claude via the claude.ai MCP connector, with Claude Code and Claude Desktop, and with Openclaw.

3. Register the agent

   Call register_agent. Eterna provisions an isolated sub-account and issues an API key instantly — no ticket, no manual review. Keys are stored Argon2-hashed and carry no withdrawal permissions.

4. Or drive it from the CLI

   Prefer a terminal? npx @eterna-hybrid-exchange/cli exposes the same registration and trading surface for scripts and CI.

5. Write strategy code against the TypeScript SDK

   The SDK exposes 29 methods (market data, orders, positions, sub-accounts) and executes in a sandboxed Deno runtime, so generated strategy code runs with restricted host access.

Wiring examples

Remote MCP server config

{
  "mcpServers": {
    "eterna": {
      "type": "http",
      "url": "https://mcp.eterna.exchange/mcp"
    }
  }
}

CLI

# interactive: register an agent and print its sub-account + API key
npx @eterna-hybrid-exchange/cli

# the CLI is the same surface the MCP server exposes,
# so anything an agent can do you can reproduce in a shell script

Agent prompt pattern that works

You have Eterna MCP tools. Rules:
1. Call register_agent once, then reuse the returned sub-account.
2. Never send more than 2% of sub-account equity per position.
3. Always set a stop before opening a position.
4. Report fills, fees (0.014% maker / 0.035% taker) and PnL after each cycle.
5. You have no withdrawal permission - never attempt transfers.

Fee awareness matters for agents more than for humans: a bot that over-trades pays the taker rate repeatedly. Model it first in the fee calculator — at 0.035% taker, 100 round trips a day on $10k notional is roughly $21 of fees per day before any PnL.

Safety notes