{
  "markdown": "# Eterna MCP Gateway\n\n**The fastest way to give your AI agent real trading capabilities.**\n\n**No KYC. Sandboxed TypeScript SDK. Isolated sub-accounts. 0.014% maker fees on futures.**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![MCP Protocol](https://img.shields.io/badge/MCP-Streamable_HTTP-green.svg)](https://modelcontextprotocol.io)\n[![Tools](https://img.shields.io/badge/Tools-3-orange.svg)](#mcp-tools)\n[![SDK](https://img.shields.io/badge/SDK_methods-29-blue.svg)](#sdk-methods-via-execute_code)\n\n---\n\n## 30-Second Install\n\nAdd to your MCP client and complete OAuth when prompted:\n\n```json\n{\n  \"mcpServers\": {\n    \"eterna\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://mcp.eterna.exchange/mcp\"\n    }\n  }\n}\n```\n\nYour agent is auto-provisioned on first sign-in. There is **no** `register_agent` tool.\n\nSee [QUICKSTART.md](QUICKSTART.md) for Claude, Cursor, and Openclaw walkthroughs.\n\nProduct site: [ai.eterna.exchange](https://ai.eterna.exchange)\n\n---\n\n## How it works\n\nEterna is **not** a one-MCP-tool-per-exchange-endpoint server.\n\n1. Agent calls **`search_sdk`** to find the right `eterna.*` method.\n2. Agent calls **`execute_code`** with TypeScript that uses the full SDK in one round-trip.\n3. Code runs in a sandboxed Deno runtime. Result is returned as JSON.\n\nThat model uses ~**90% fewer tokens** than wrapping every Bybit call as a separate MCP tool.\n\n---\n\n## MCP tools\n\n| Tool | Description |\n|---|---|\n| `execute_code` | Run TypeScript in a Deno sandbox with the `eterna.*` trading SDK |\n| `search_sdk` | Search SDK docs (`list` / `summary` / `full` / `params` / `keywords`) |\n| `search_examples` | Semantic search over curated trading examples |\n\n### Prompts\n\n| Prompt | Description |\n|---|---|\n| `getting_started` | How to use `execute_code`, deposit flow, sandbox rules |\n| `sdk_reference` | Full `eterna.*` method signatures and response shapes |\n| `error_handling` | Error categories and recovery |\n| `technical_analysis` | RSI, MACD, EMA, SMA, Bollinger, VWAP |\n| `strategy_momentum_scalping` | Optional strategy template |\n| `strategy_mean_reversion` | Optional strategy template |\n| `strategy_funding_rate_arbitrage` | Optional strategy template |\n\n### Resources\n\n| URI | Description |\n|---|---|\n| `eterna://docs/sdk` | Complete SDK reference |\n| `eterna://docs/errors` | Error reference |\n| `eterna://docs/examples` | Example snippets |\n\nFull parameter docs: [docs/tools-reference.md](docs/tools-reference.md)\n\n---\n\n## SDK methods (via `execute_code`)\n\n29 methods on the `eterna` object inside the sandbox:\n\n| Category | Methods |\n|---|---|\n| **Market data** | `getTickers`, `getOrderbook`, `getInstruments` |\n| **Technical analysis** | `getRsi`, `getMacd`, `getEma`, `getSma`, `getBollingerBands`, `getVwap` |\n| **Trading** | `placeOrder`, `closePosition`, `cancelOrder`, `cancelAllOrders`, `setLeverage`, `setTradingStop` |\n| **Account** | `getBalance`, `getAccountInfo`, `getAllCoinsBalance`, `getPositions`, `getOrders` |\n| **Funding** | `getDepositAddress`, `getDepositRecords`, `getAllowedDepositCoins`, `transferToTrading`, `swapToUsdt`, `getCoinInfo`, `getWithdrawableAmount`, `submitWithdrawal`, `getWithdrawalStatus` |\n\nExample:\n\n```typescript\nconst balance = await eterna.getBalance();\nconst ticker = await eterna.getTickers(\"BTCUSDT\");\nreturn { equity: balance.totalEquity, last: ticker[0]?.lastPrice };\n```\n\n---\n\n## Why Eterna?\n\n| | Eterna (managed) | Self-hosted MCP servers | Direct API wrappers |\n|---|---|---|---|\n| **Setup time** | ~30 seconds | 15-30 min | Hours |\n| **Auth** | OAuth (or legacy API key) | You create & rotate keys | You create & rotate keys |\n| **Agent isolation** | Dedicated sub-account per agent | Shared account | Shared account |\n| **Execution model** | Sandboxed TypeScript SDK | Usually one tool per endpoint | Custom code |\n| **Transport** | Streamable HTTP (remote) | Often stdio (local only) | HTTP |\n| **Maintenance** | Zero — we handle updates | You manage | You manage |\n| **Futures fees** | 0.014% maker / 0.035% taker | Retail unless you negotiate VIP | Retail unless you negotiate VIP |\n\n### What you don't have to build\n\n- Sub-account provisioning\n- Rate limiting and request validation\n- Deposit address management and fund routing\n- Error handling for exchange API changes\n- A Deno sandbox + typed trading SDK\n\n---\n\n## Works with your stack\n\n### Claude (claude.ai)\n\nAdd a custom connector with URL `https://mcp.eterna.exchange/mcp`, complete OAuth, Approve.\n\n### Claude Code / Cursor\n\nUse the JSON config above (Claude Code: `.mcp.json`, Cursor: `.cursor/mcp.json`). Complete OAuth when prompted.\n\n### Openclaw\n\n```bash\nopenclaw plugins install @eterna-hybrid-exchange/openclaw-plugin\nnpm install -g @eterna-hybrid-exchange/cli\neterna login\n```\n\n### Any Streamable HTTP MCP client\n\nPoint 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.\n\n---\n\n## Authentication\n\n**Preferred:** OAuth via [`https://ai-auth.eterna.exchange`](https://ai-auth.eterna.exchange) with scope `mcp:full`.\n\n**Legacy:** long-lived agent API keys as `Authorization: Bearer …` (Argon2 hashed at rest).\n\nDetails: [docs/authentication.md](docs/authentication.md)\n\n---\n\n## Markets\n\n- **USDT-margined perpetual futures** (200+ pairs)\n- Spot trading is on the roadmap\n\n---\n\n## Roadmap\n\nSee [ROADMAP.md](ROADMAP.md).\n\n**Shipped:** code execution sandbox, OAuth agent provisioning, 29 SDK methods, technical analysis, funding/withdrawal flows.\n\n**Next:** broader SDK coverage, cron strategy runtime, backtesting, spot.\n\n---\n\n## Skills\n\nClaude Code skills for trading knowledge:\n\n- **[skills/claude-code/trading/SKILL.md](skills/claude-code/trading/SKILL.md)** — Risk management, position sizing, deposit flow, order lifecycle\n- **[skills/claude-code/scalping/SKILL.md](skills/claude-code/scalping/SKILL.md)** — Momentum scalping strategy\n\nOr grab the latest bundle: https://ai.eterna.exchange/claude-skills\n\n---\n\n## Documentation\n\n- [QUICKSTART.md](QUICKSTART.md) — Connect and trade\n- [Tools Reference](docs/tools-reference.md) — MCP tools + SDK overview\n- [Authentication](docs/authentication.md) — OAuth and API keys\n- [Architecture](docs/architecture.md) — Isolation and transport\n- [CHANGELOG.md](CHANGELOG.md) — Version history\n- [ROADMAP.md](ROADMAP.md) — What's next\n\nMachine-readable product facts: https://ai.eterna.exchange/llms.txt\n\n---\n\n## Contact\n\nQuestions, partnerships, or support: **contact@eterna.exchange**\n\n---\n\n## License\n\n[MIT](LICENSE) — Copyright 2025-2026 Eterna Exchange\n",
  "bytes": 6631,
  "sha": "9be8ce54378ab2bbb8f375b151176b3090c21580d054dd93c55a329fcecffb79",
  "repo_slug": "eternahybridexchange/eterna-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_eternahybridexchange_eterna_mc_4c6147f1/readme"
}