Have an MCP-compatible client ready. Check your Eterna account eligibility and, if you intend to use a referral, its attribution before completing account creation.

1. Choose your client

Claude web

  1. Open Claude’s custom connectors in your account.
  2. Add a connector named Eterna using the endpoint below.
  3. Connect and complete the official OAuth sign-in. Review the requested access before approval.
https://mcp.eterna.exchange/mcp

Custom connector access depends on your client and account. Follow the official quickstart if the interface differs.

Claude Code configuration and Cursor status

The Eterna quickstart provides this configuration for .cursor/mcp.json in Cursor or .mcp.json in Claude Code. Merge it with existing servers instead of overwriting your configuration.

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

Reload the client if needed, then complete OAuth. No seed phrase or private key belongs in this file.

2. Check the tools

Look for search_sdk, execute_code and search_examples. The current gateway has no register_agent tool: agent provisioning happens through sign-in.

3. Ask for a market observation

Use search_sdk to discover the BTCUSDT ticker method and its parameters. Then use execute_code only to read its latest market price. Report the source and timestamp if supplied. Do not place, modify or cancel orders, change leverage, transfer funds or withdraw.

Check that the result contains BTCUSDT data from the connected tool. An invented answer or a text explanation without a tool call does not validate the connection. Do not infer a timestamp if the response does not include one.

4. Troubleshoot the first session

No tools appear
Check the endpoint, remote transport support and whether the connector is enabled. Reload the client.
Authentication error
Reconnect through official OAuth and check account access. Do not paste credentials into a public chat.
Unknown method or parameters
Discover the current SDK signature with search_sdk before execution; old per-endpoint MCP examples may not apply.
The client proposes a trade
Decline the action. Recheck tool approvals and permission settings before continuing the observation.

5. Validate the result before expanding the workflow

A successful connection should produce a tool result, not merely a plausible price written by the assistant. Check the symbol, market type, source method and any supplied timestamp. If the response lacks a timestamp, record when you received it and label that as your observation time.

  1. Confirm the client lists the expected MCP tools.
  2. Inspect the discovered method signature before execution.
  3. Review the proposed code: a market query should not contain an order, transfer, leverage change or withdrawal.
  4. Check that returned values have units and are not an error payload.
  5. Keep a redacted record of the request and result; remove account identifiers and secrets before sharing.

Review the previous tool response without calling any trading or account-changing method. Identify its symbol, market type, units and timestamp if present. Separate returned facts from your interpretation. If data is missing or stale, say so; do not invent values or place an order.

6. Understand what a prompt cannot enforce

“Read only” in a prompt is an instruction, not a technical permission boundary. Inspect client approvals and account scopes. If the integration exposes execution methods, do not treat a successful ticker query as proof that trading is disabled. Revoke unused access through the official account/client controls.

Which official source should I follow?

The AI portal advertises Claude and Openclaw support and labels Cursor as coming soon. The technical quickstart also contains a Cursor example. Its gateway instructions use OAuth and three MCP tools, while the marketing FAQ mentions register_agent. These sources differ. This guide follows the gateway quickstart for connection mechanics; confirm the tools exposed by your actual session rather than assuming every marketing example is current.

What has been verified here?

This guide follows the official quickstart rechecked on 17 October 2026. No authenticated Eterna session or live trade was performed for this guide. Review current instructions and test your own connection before relying on it.

Official client quickstart ↗ · Gateway repository ↗

Referral and agent accounts

Opening a referral link does not prove that an OAuth-provisioned sub-account inherits it. Confirm account attribution with Eterna. This guide cannot attach or change a referral after signup.

S
Steve · Independent affiliate guideEditorial update 17 October 2026 · Fee sources reviewed 5 October 2026