Eterna MCP
No-KYC managed MCP for AI agents: sandboxed TypeScript trading SDK, isolated sub-accounts, futures.
Que pouvez-vous faire avec Eterna MCP ?
- 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
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http eterna-mcp 'https://mcp.eterna.exchange/mcp' --header 'Authorization: <Bearer token from OAuth (ai-auth) or agent API key after register_agent. See https://github.com/EternaHybridExchange/eterna-mcp/blob/main/docs/authentication.md>'
{
"mcpServers": {
"eterna-mcp": {
"type": "http",
"url": "https://mcp.eterna.exchange/mcp",
"headers": {
"Authorization": "<Bearer token from OAuth (ai-auth) or agent API key after register_agent. See https://github.com/EternaHybridExchange/eterna-mcp/blob/main/docs/authentication.md>"
}
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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.
- Agent calls
search_sdkto find the righteterna.*method. - Agent calls
execute_codewith TypeScript that uses the full SDK in one round-trip. - 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
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: contact@eterna.exchange
License
MIT — Copyright 2025-2026 Eterna Exchange
Questions fréquentes
Qu'est-ce que Eterna MCP ?
No-KYC managed MCP for AI agents: sandboxed TypeScript trading SDK, isolated sub-accounts, futures.
Comment installer Eterna MCP ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http eterna-mcp 'https://mcp.eterna.exchange/mcp' --header 'Authorization: <Bearer token from OAuth (ai-auth) or agent API key after register_agent. See https://github.com/EternaHybridExchange/eterna-mcp/blob/main/docs/authentication.md>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Eterna MCP ?
Oui. Il attend Authorization, à renseigner dans sa configuration.
Eterna MCP est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Eterna MCP ?
Il est publié par EternaHybridExchange. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.