EOR Scope

eorscope-mcp

一个通过标准输入/输出（stdio）运行的模型上下文协议服务，在支付任何雇主代表（EOR）费用之前，回答一个有关海外招聘的问题：在指定国家，除毛薪外，雇主还需支付哪些费用（法定雇主缴款逐项列出，并注明各项来源；如有官方来源，则优先使用官方来源，同时标明读取日期）。

其中不包含 EOR 服务商的费用：服务商的条款不允许转售其价格信息。请在服务商各自的定价页面比较价格。

它使用与 EOR Scope 计算器相同的引擎和数据：截至 2026-10-04 的快照涵盖 76 个国家。数据随软件包一同发布；服务不会发起网络请求。

费用对比，不构成法律或税务建议。

远程服务（无需安装）

https://mcp.eorscope.com/mcp（Streamable HTTP，无需身份验证，只读）运行本仓库的 main 分支：提供 14 个工具（雇主成本、国家和聘用方案对比、预算转薪资、报价核查、EOR／实体／承包商成本、雇佣条款、汇率压力测试、承包商费率、定期更新、下一年度成本），并为 ChatGPT 和其他 MCP Apps 宿主提供两个显示组件。若有该国法定发薪次数的数据，则会按该次数将月薪换算成年薪。文档：https://mcp.eorscope.com/docs.html。

以下 npm 软件包（0.2.0）是较早的 stdio 服务：提供四个工具，使用相同的引擎。

安装

Node 18 或更高版本。

Claude Code：

claude mcp add eorscope -- npx -y eorscope-mcp

Claude Desktop，或任何能读取 mcpServers 配置块的客户端：

{
  "mcpServers": {
    "eorscope": {
      "command": "npx",
      "args": ["-y", "eorscope-mcp"]
    }
  }
}

工具

每个回答均为 JSON，并以 meta 块结尾：其中包含快照日期、网站上对应页面的 URL、方法论页面的 URL、免责声明和数据许可。以下示例均为 2026-10-04 快照的实际输出；标有 … 的部分已缩短；省略了 meta。

数值会以文本形式（"at least $156"）以及 values 下的数字形式返回，并附带 bound 字段。如果某个国家的总额标注为下限或上限，数值中的“至少”或“至多”也是其组成部分：引用时请保留。

list_countries

可选参数 region。按字母顺序排列。

{
  "count": 6,
  "countries": [
    { "iso": "IL", "name": "Israel", "slug": "israel", "region": "Middle East", "currency": "ILS", "example_salary_usd": 75000, "employer_cost_at_example": "at least 15.4%" },
    { "iso": "JO", "name": "Jordan", "slug": "jordan", "region": "Middle East", "currency": "JOD", "example_salary_usd": 24000, "employer_cost_at_example": "14.3%" },
    …
  ]
}

employer_cost

country（ISO 代码或国家名称）、可选的 salary 和 salary_currency（USD 或 local）、可选的 assumptions、可选的 include_notes。如果未提供薪资，则使用该国的示例薪资。{"country": "India"} 会返回 印度页面上列出的数值：

{
  "summary": "One employee in India at $30,000 gross a year costs about $154 a month in statutory employer charges (+6.2% of gross), before any EOR fee.",
  "salary": {
    "annual_usd": 30000,
    "annual_local": "INR 2,876,322",
    "is_country_example": "example salary (software engineer), not a median",
    "fx": { "local_per_usd": 95.8774, "date": "2026-09-18", "source": "European Central Bank — euro foreign exchange reference rates" }
  },
  "employer_cost": {
    "pct_of_gross": "6.2%",
    "monthly": "$154",
    "annual": "$1,850",
    "values": { "bound": null, "pct_of_gross": 6.1659, "monthly_usd": 154.15, "annual_usd": 1849.77 }
  },
  "lines": [
    {
      "id": "epf_employer",
      "name": "EPF employer contribution (Employees' Provident Fund)",
      "type": "contribution",
      "rate": 0.0367,
      "rate_printed": "3.67%",
      "base": "basic",
      "base_cap_annual_local": 300000,
      "currency": "INR",
      "capped": true,
      "annual_usd": 114.83,
      "monthly_usd": 9.57,
      "applies": "Applies to basic wage plus dearness allowance, capped at the statutory wage ceiling of Rs 25,000/month (in force since 17 September 2026)",
      "source": {
        "name": "Employees' Provident Fund Organisation - FAQs on the revision of the EPFO statutory wage ceiling (Rs 15,000 to Rs 25,000, S.O. 5109(E))",
        "url": "https://pmvbry-cdn.epfindia.gov.in/wp-content/uploads/2026/09/EPFO_Wage_Ceiling_FAQs.pdf",
        "checked_at": "2026-09-26"
      }
    },
    …
  ],
  "assumptions": [{ "id": "basic_share_of_gross", "label": "Basic wage as a share of gross", "value": 0.5 }]
}

compare_countries

countries（2 至 10 个国家）和 salary_usd。返回的行按请求顺序排列，而非按排名排列。{"countries": ["DE", "PL", "AE"], "salary_usd": 80000}：

{
  "salary_annual_usd": 80000,
  "countries": [
    { "iso": "DE", "name": "Germany", "salary_local": "EUR 69,808", "employer_cost": { "pct_of_gross": "22.2%", "monthly": "$1,483", "annual": "$17,793", … } },
    { "iso": "PL", "name": "Poland", "salary_local": "PLN 304,607", "employer_cost": { "pct_of_gross": "19.8%", "monthly": "$1,320", "annual": "$15,844", … } },
    { "iso": "AE", "name": "United Arab Emirates", "salary_local": "AED 293,800", "employer_cost": { "pct_of_gross": "at least 2.9%", "monthly": "at least $192", "annual": "at least $2,301", … } }
  ]
}

来源和方法

• 雇主缴款：各国的税务和社会保障管理机构，以及各国法律法规。每一项都附有来源 URL 和读取日期；若依据的是次要来源，会在备注中说明（include_notes）。
• 汇率：欧洲央行参考汇率；与美元挂钩的货币采用发行国中央银行的平价汇率；其他货币采用欧盟委员会月度会计汇率。每个回答都会列出汇率、日期和来源。
• 计算：分别按每项缴款的计费基数（毛薪、基本工资、固定金额或毛薪区间）计算，并按法律规定设置下限和上限；薪资未达到门槛时则跳过该项；此外还会计入该国总额中包含的定期法定额外支出。不对员工承担的扣款和所得税建模。

完整方法、已知局限和来源列表请见方法论页面。

这些数字是对法定费用的示例性建模。招聘前，请务必向合格的当地顾问确认每一项数据。

开发

npm ci
npm run build   # bundles src/ into dist/
npm test        # the built package against the site's published dataset, country by country, then over stdio

引擎是网站自有的，并非重写版本；它不适用其余代码的 MIT 条款（请参阅 Licence）。src/vendor/（引擎和格式化程序）、data/snapshot.json 和 test/fixtures/country_summary.csv 均通过 npm run sync 从网站的仓库复制而来；请勿在此处编辑它们。sync 只有在该仓库中才有用。在单独检出的此软件包中运行时，它会说明这一点，并且不会更改任何内容。

许可

分为三个部分，适用三套条款，均列于 LICENSE 中：

• 服务端代码（src/ 中 src/vendor/ 以外的部分、scripts/、测试、文档）：MIT。
• 成本引擎（src/vendor/ 及其在 dist/ 中的打包版本）：版权所有 © EOR Scope，保留所有权利。该引擎仅随本软件包分发：你可以将其作为 eorscope-mcp 的一部分运行，但不得单独提取、修改或再分发。
• 数据（data/snapshot.json、test/fixtures/）：CC BY 4.0，署名为“EOR Scope, eorscope.com”。条款见 LICENSE-DATA。

由 EOR Scope 发布。