eToro Trading MCP

eToro Trading MCP

面向 eToro 公共 Swagger UI API 的本地 Model Context Protocol 服务。它的主要用途是为 AI Agent 配置：在 MCP 客户端中注册一次，然后仅启用 Agent 所需的工具集。命令行仅用于本地检查（tools list、config validate），不用于日常操作。

此 MCP 每天都会扫描 eToro API 是否有更新：自动化每日任务会下载 eToro 当前的 OpenAPI 文档，检测上游变更，并创建一个包含全面重新生成且经过验证的工具的拉取请求——不会自动合并或发布任何内容。

使用 AI Agent 安装

将以下指令提供给你的编码 Agent 或桌面 Agent：

Install and configure this MCP server by following https://github.com/n-kostadinov/etoro-trading-mcp/blob/main/INSTALL.md

面向 Agent 的指南也提供了原始 Markdown版本。

你将获得

• 197 个细粒度 MCP 工具，由 eToro Swagger UI 生成——每个 REST 操作对应一个工具。
• 27 个默认全部禁用的工具集：只有在配置中列出工具集或工具，才能启用它们。启用某个工具集会启用其中的所有工具。
• 适用于模拟环境的示例配置：ETORO_ENABLED_TOOLSETS=market-data,trading-demo 可启用 28 个工具（11 个市场数据工具和 17 个当前的模拟交易工具），不会动用真实资金。
• 只有在启用实盘资金操作工具并且设置 ETORO_ALLOW_REAL_MONEY=true 后，实盘资金变更操作才会显示。
• 旧版操作只有在明确选择启用 includeDeprecated 后才可用。
• TypeScript、Node.js 22+、stdio 传输方式，以及一条 npx 命令——无需全局安装。
• 自动请求 ID、共享速率限制跟踪、保守重试、结构化 HTTP 响应和凭据脱敏。

快速了解：配置你的 Agent

所有工具集默认均处于禁用状态。典型且适用于模拟环境的 MCP 客户端配置项：

{
  "mcpServers": {
    "etoro": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "ETORO_API_KEY": "<user-supplied-application-key>",
        "ETORO_USER_KEY": "<user-supplied-user-key>",
        "ETORO_ENABLED_TOOLSETS": "market-data,trading-demo",
        "ETORO_ALLOW_REAL_MONEY": "false"
      }
    }
  }
}

凭据仅通过环境变量提供。可以使用一组 API 密钥和用户密钥，或 OAuth bearer token——不能同时使用，也不能使用门户网站密码。

如何找到 x-api-key 和 x-user-key

这组密钥来自 eToro 的 API Key Management 页面——打开带注释的截图，即可准确查看各个值的对应关系：

• x-api-key — 页面顶部显示的公钥。它用于标识你的应用，并通过 ETORO_API_KEY 提供给此服务。
• x-user-key — 使用 Create Your API Key 创建的密钥之一；它会显示在 Generated Keys 列表中，用于标识你的 eToro 用户，并通过 ETORO_USER_KEY 提供。

每个经过身份验证的请求都会同时发送这两个标头。请从具有 Read & Write 权限的 Demo 密钥开始；完整操作指南请参阅 INSTALL.md。

如何启用工具

用途	环境变量	JSON 文件属性
启用工具集（每个工具集中的所有工具）	ETORO_ENABLED_TOOLSETS=market-data,trading-demo	"enabledToolsets": ["market-data", "trading-demo"]
启用单个工具	ETORO_ENABLED_TOOLS=getRates,getMe	"enabledTools": ["getRates", "getMe"]
允许使用旧版工具	ETORO_INCLUDE_DEPRECATED=true	"includeDeprecated": true
允许涉及真实资金的变更	ETORO_ALLOW_REAL_MONEY=true	"allowRealMoney": true

环境变量中的列表以逗号分隔；JSON 属性使用数组。优先级为内置默认值 < JSON 文件（ETORO_CONFIG）< 环境变量 < CLI 标志；优先级较高的配置层会替换（而非合并）列表。以下是使用显式 JSON 文件的相同示例（ETORO_CONFIG=/absolute/path/to/etoro-mcp.config.json）：

{
  "$schema": "https://raw.githubusercontent.com/n-kostadinov/etoro-trading-mcp/main/schemas/config.schema.json",
  "enabledToolsets": ["market-data", "trading-demo"],
  "includeDeprecated": false,
  "allowRealMoney": false
}

有关所有设置，请参阅配置。

两项安全限制与选择设置相互独立：使用旧版工具还需要设置 includeDeprecated，涉及真实资金的变更还需要设置 allowRealMoney。涉及真实资金的变更位于四个工具集中：trading-real、copy-trading、transfer 和 sub-accounts-etoro-trading。因此，只有同时启用第二项安全限制，启用这些工具集才会开放涉及真实资金的操作。

可用工具集（27 个）

工具集	当前	旧版		工具集	当前	旧版
agent-portfolios	7	3		rankings	7	0
app-data	1	0		social-feeds	37	4
balances	6	0		sso-applications	5	0
cash-accounts	1	0		sso-scopes	1	0
clubs	1	0		sub-accounts	2	0
copy-trading ⚠️	5	0		sub-accounts-etoro-trading ⚠️	6	0
copy-trading-demo	5	0		top-assets	1	0
data	4	0		trading-demo	17	6
identity	1	0		trading-real ⚠️	17	6
market-data	11	0		transfer ⚠️	7	0
notifications	2	0		user-stats	4	0
pi-data	1	0		users-info	6	0
portfolio-search	1	0		watchlists	18	0
price-alerts	4	0

⚠️ 表示这些工具集包含涉及真实资金的变更（无论如何选择，均受 allowRealMoney 限制）。“当前”工具在启用工具集后即可使用；“旧版”工具还需要设置 includeDeprecated。每个操作 ID 都列在工具参考中；工具集的详细信息请参阅工具集。

本地检查（次要方式）

CLI 执行以下命令时不会联系 eToro，且无需凭据：

npx -y [email protected] tools list --all    # every operation and its state
npx -y [email protected] config validate     # effective settings and warnings

文档

• INSTALL — 完整的 Agent 和手动设置指南
• 配置 — 文件／环境变量／CLI 的优先级和所有设置
• 工具集 — 全部 27 个工具集及其数量
• 工具参考 — 每个生成的工具、请求、权限范围替代项和替换项
• 交易 — 模拟交易与真实资金、权限范围、异步订单和安全性
• 安全性 — 凭据、本地文件、诊断和不可信内容
• 故障排除 — 启动、身份验证、限制和配置问题

安全性和项目状态

这是一个独立的非官方项目，与 eToro 无关联，未获其认可或赞助。eToro 名称和商标归 eToro 所有。本仓库中的任何内容均不构成投资建议。模拟交易使用虚拟资金；真实交易可能造成实际资金损失，且需要两项明确的选择确认。

当前版本：1.0.1，根据 eToro Swagger UI v1.400.0 生成。每日自动化会在 eToro 发布的 API 发生变更时创建审核拉取请求；它绝不会自动合并、打标签或发布。

参与贡献

采用 MIT 许可证。开发、发布历史和报告指南请参阅 CONTRIBUTING.md、CHANGELOG.md 和 SECURITY.md。