stevevstd-oss/eterna-mcp-agent-starter

Listed on awesome-mcp-servers
Build an AI trading agent on Eterna Hybrid Exchange in under 30 minutes — using Claude (MCP), the official CLI, or sandboxed TypeScript strategies. Ships with its own MCP server: fee estimator, venue comparison, setup guides and guarded agent prompts that work without an account, plus an authenticated bridge to the official Eterna MCP endpoint.
Eterna is a no-KYC perpetual futures exchange with flat fees (0.014% maker / 0.035% taker), CEX-grade liquidity routed from Bybit, and native AI-agent tooling: an MCP server, a CLI, and a managed TypeScript sandbox with an injected eterna. SDK.
> Affiliate disclosure: links to Eterna in this repo use referral code Steve. Signing up through them costs you nothing extra — fees are identical — and supports this project.
## Why Eterna for agents
| | Eterna | Typical setup (direct CEX API) |
| KYC | None — wallet auth | Full KYC |
| Taker fee | Flat 0.035% | 0.045%+ before volume tiers |
| Maker fee | Flat 0.014% | 0.015%+ |
| Agent access | Native MCP server + CLI + sandbox SDK | Roll your own REST/WS client |
| Agent safety | Isolated sub-account, no withdrawal rights | API key scoping varies |
| Liquidity | $10B+ routed from Bybit order books, <200ms | Depends on venue |
Run your own numbers: Eterna vs Hyperliquid fee calculator · full comparison.
## Path 0 — Run the starter MCP server
A stdio MCP server that any client (Claude Desktop, Claude Code, Cursor, Windsurf, Glama) can launch. It needs no credentials to start.
json
"mcpServers": {
"eterna-starter": {
"command": "npx",
"args": ["-y", "github:stevevstd-oss/eterna-mcp-agent-starter"]
| Tool | Needs account | What it does |
| eternafeeestimate | No | Monthly fees for a volume and maker/taker mix, plus EHX credited via EHX Payback |
| eternacomparefees | No | Same volume across Eterna, Hyperliquid, Bybit, Binance — with sources |
| eternasetupguide | No | Step-by-step for claude, cli, generic-mcp or starter-server |
| eternaagentprompt | No | Guarded trading-agent prompt (1% risk cap, mandatory SL/TP, approval gate) |
| eternaconnectionstatus | No | Whether the bridge is active and how to authenticate |
| Official Eterna tools | Yes | Bridged from https://mcp.eterna.exchange/mcp when a token is available |
Bridge mode. Set ETERNAACCESSTOKEN in the server's env, or run npx @eterna-hybrid-exchange/cli login once — the server reads ~/.eterna/credentials.json (override with ETERNACONFIGDIR) and refreshes it when needed. Every tool exposed by the official endpoint then appears next to the local ones.
bash
# From source
git clone https://github.com/stevevstd-oss/eterna-mcp-agent-starter && cd eterna-mcp-agent-starter
npm install && npm run build && npm test
# Docker
docker build -t eterna-mcp-agent-starter .
docker run -i --rm -e ETERNAACCESSTOKEN eterna-mcp-agent-starter
Environment variables: ETERNAACCESSTOKEN (optional), ETERNACONFIGDIR (default ~/.eterna), ETERNAMCPURL (default https://mcp.eterna.exchange/mcp), ETERNAAUTHISSUER (default https://ai-auth.eterna.exchange).
## Path 1 — Claude with MCP (no code)
1. Sign up at ehx.app (wallet signature, ~2 minutes, no KYC).
2. In Claude: Customize → Connectors → Add Custom Connector.