eToro Public API MCP

A Model Context Protocol (MCP) server exposing the eToro Public API route catalog. It refreshes the public API OpenAPI (swagger) document every few minutes, serves the route catalog through MCP tools, and proxies route execution to the eToro Public API via the execute tools.

Endpoint

The MCP endpoint (streamable HTTP, stateless) is served at the root path: POST /

Tools

ToolDescription
get-all-routes Returns all available eToro Public API routes with a short explanation for each. Partner-only routes appear automatically when the MCP connection carries a partner application's x-api-key header.
get-route-spec Returns the full OpenAPI specification (parameters, responses, referenced schemas) for a route by its route id. Partner-only routes resolve on a connection carrying a partner x-api-key header.
execute-read Executes a read against the eToro Public API and relays the response (status, body, rate-limit info): every GET route, plus the read-semantics POST routes (cost previews, eligibility dry-runs, bulk lookups) via an optional raw-JSON-string body — the server verifies the route is read-only before sending. Credentials travel on the MCP connection's own headers (x-user-key + x-api-key, or Authorization: Bearer), never as tool arguments. The x-request-id header is generated automatically and returned.
execute-write Executes a state-changing route (POST/PUT/PATCH/DELETE) with an optional raw-JSON-string body — same connection-header credential rules as execute-read. The returned xRequestId can be passed back to retry the same operation idempotently.

Client configuration example

{
  "mcpServers": {
    "etoro-public-api": {
      "url": "<service-url>/"
    }
  }
}

Agent skill

Download a ready-to-use agent skill, pre-configured with this environment's MCP and eToro Public API URLs: Download SKILL.md.

Install it by placing the file at: