The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Eterna MCP listing page.
The fastest way to give your AI agent real trading capabilities.
No KYC. Sandboxed TypeScript SDK. Isolated sub-accounts. 0.014% maker fees on futures.
Add to your MCP client and complete OAuth when prompted:
Your agent is auto-provisioned on first sign-in. There is no register_agent tool.
See QUICKSTART.md for Claude, Cursor, and Openclaw walkthroughs.
Product site: ai.eterna.exchange
Eterna is not a one-MCP-tool-per-exchange-endpoint server.
search_sdk to find the right eterna.* method.execute_code with TypeScript that uses the full SDK in one round-trip.That model uses ~90% fewer tokens than wrapping every Bybit call as a separate MCP tool.
| Tool | Description |
|---|---|
execute_code | Run TypeScript in a Deno sandbox with the eterna.* trading SDK |
search_sdk | Search SDK docs (list / summary / full / params / keywords) |
search_examples | Semantic search over curated trading examples |
| Prompt | Description |
|---|---|
getting_started | How to use execute_code, deposit flow, sandbox rules |
sdk_reference | Full eterna.* method signatures and response shapes |
error_handling | Error categories and recovery |
technical_analysis | RSI, MACD, EMA, SMA, Bollinger, VWAP |
strategy_momentum_scalping | Optional strategy template |
strategy_mean_reversion | Optional strategy template |
strategy_funding_rate_arbitrage | Optional strategy template |
| URI | Description |
|---|---|
eterna://docs/sdk | Complete SDK reference |
eterna://docs/errors | Error reference |
eterna://docs/examples | Example snippets |
Full parameter docs: docs/tools-reference.md
execute_code)29 methods on the eterna object inside the sandbox:
| Category | Methods |
|---|---|
| Market data | getTickers, getOrderbook, getInstruments |
| Technical analysis | getRsi, getMacd, getEma, getSma, getBollingerBands, getVwap |
| Trading | placeOrder, closePosition, cancelOrder, cancelAllOrders, setLeverage, setTradingStop |
| Account | getBalance, getAccountInfo, getAllCoinsBalance, getPositions, getOrders |
| Funding | getDepositAddress, getDepositRecords, getAllowedDepositCoins, transferToTrading, swapToUsdt, getCoinInfo, getWithdrawableAmount, submitWithdrawal, getWithdrawalStatus |
Example:
| Eterna (managed) | Self-hosted MCP servers | Direct API wrappers | |
|---|---|---|---|
| Setup time | ~30 seconds | 15-30 min | Hours |
| Auth | OAuth (or legacy API key) | You create & rotate keys | You create & rotate keys |
| Agent isolation | Dedicated sub-account per agent | Shared account | Shared account |
| Execution model | Sandboxed TypeScript SDK | Usually one tool per endpoint | Custom code |
| Transport | Streamable HTTP (remote) | Often stdio (local only) | HTTP |
| Maintenance | Zero — we handle updates | You manage | You manage |
| Futures fees | 0.014% maker / 0.035% taker | Retail unless you negotiate VIP | Retail unless you negotiate VIP |
Add a custom connector with URL https://mcp.eterna.exchange/mcp, complete OAuth, Approve.
Use the JSON config above (Claude Code: .mcp.json, Cursor: .cursor/mcp.json). Complete OAuth when prompted.
Point the client at https://mcp.eterna.exchange/mcp and authenticate with OAuth (mcp:full) or a legacy Bearer API key. Polished guides for LangChain / CrewAI / AutoGen / ChatGPT are expanding.
Preferred: OAuth via https://ai-auth.eterna.exchange with scope mcp:full.
Legacy: long-lived agent API keys as Authorization: Bearer … (Argon2 hashed at rest).
Details: docs/authentication.md
See ROADMAP.md.
Shipped: code execution sandbox, OAuth agent provisioning, 29 SDK methods, technical analysis, funding/withdrawal flows.
Next: broader SDK coverage, cron strategy runtime, backtesting, spot.
Claude Code skills for trading knowledge:
Or grab the latest bundle: https://ai.eterna.exchange/claude-skills
Machine-readable product facts: https://ai.eterna.exchange/llms.txt
Questions, partnerships, or support: contact@eterna.exchange
MIT — Copyright 2025-2026 Eterna Exchange