Eterna MCP

Eterna MCP Gateway

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.

---

30-Second Install

Add to your MCP client and complete OAuth when prompted:

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

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

---

How it works

Eterna is not a one-MCP-tool-per-exchange-endpoint server.

1. Agent calls search_sdk to find the right eterna.* method.
2. Agent calls execute_code with TypeScript that uses the full SDK in one round-trip.
3. Code runs in a sandboxed Deno runtime. Result is returned as JSON.

That model uses ~90% fewer tokens than wrapping every Bybit call as a separate MCP tool.

---

MCP tools

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

Prompts

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

Resources

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

---

SDK methods (via execute_code)

30 methods on the eterna object inside the sandbox (linear perps default; USDT spot via market: "spot" and sellSpotBalance):

Category	Methods
Market data	getTickers, getOrderbook, getInstruments (optional market: linear or spot)
Technical analysis	getRsi, getMacd, getEma, getSma, getBollingerBands, getVwap
Trading	placeOrder, sellSpotBalance, closePosition, cancelOrder, cancelAllOrders, setLeverage, setTradingStop
Account	getBalance, getAccountInfo, getAllCoinsBalance, getPositions, getOrders
Funding	getDepositAddress, getDepositRecords, getAllowedDepositCoins, transferToTrading, swapToUsdt, getCoinInfo, getWithdrawableAmount, submitWithdrawal, getWithdrawalStatus

Example:

const balance = await eterna.getBalance();
const ticker = await eterna.getTickers("BTCUSDT");
return { equity: balance.totalEquity, last: ticker[0]?.lastPrice };

---

Why Eterna?

	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

What you don't have to build

• Sub-account provisioning
• Rate limiting and request validation
• Deposit address management and fund routing
• Error handling for exchange API changes
• A Deno sandbox + typed trading SDK

---

Works with your stack

Claude (claude.ai)

Add a custom connector with URL https://mcp.eterna.exchange/mcp, complete OAuth, Approve.

Claude Code / Cursor

Use the JSON config above (Claude Code: .mcp.json, Cursor: .cursor/mcp.json). Complete OAuth when prompted.

Openclaw

openclaw plugins install @eterna-hybrid-exchange/openclaw-plugin
npm install -g @eterna-hybrid-exchange/cli
eterna login

Any Streamable HTTP MCP client

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.

---

Authentication

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

---

Markets

• USDT-margined perpetual futures (200+ pairs, default market: "linear")
• USDT spot via placeOrder({ …, market: "spot" }), sellSpotBalance(symbol), and spot-aware market data / order methods

See docs/tools-reference.md.

---

Roadmap

See ROADMAP.md.

Shipped: code execution sandbox, OAuth agent provisioning, 30 SDK methods (perps + USDT spot), technical analysis, funding/withdrawal flows.

Next: broader SDK coverage, cron strategy runtime, backtesting.

---

Skills

Claude Code skills for trading knowledge:

• skills/claude-code/trading/SKILL.md — Risk management, position sizing, deposit flow, order lifecycle
• skills/claude-code/scalping/SKILL.md — Momentum scalping strategy

Or grab the latest bundle: https://ai.eterna.exchange/claude-skills

---

Documentation

• QUICKSTART.md — Connect and trade
• Tools Reference — MCP tools + SDK overview
• Authentication — OAuth and API keys
• Architecture — Isolation and transport
• CHANGELOG.md — Version history
• ROADMAP.md — What's next

Machine-readable product facts: https://ai.eterna.exchange/llms.txt

---

Contact

Questions, partnerships, or support: [email protected]

---

License

MIT — Copyright 2025-2026 Eterna Exchange