Tools Berry Paycheck

Tools Berry MCP server

一个用于解答 2026 年美国薪资和工资税问题的 MCP 服务，使用真实计算而非猜测：到手工资、奖金预扣税、州际比较，以及全部 50 个州和 DC 的各州税率表。

服务已托管，可免费使用。无需安装或运行任何内容。

端点： https://mcp.tools-berry.com — Streamable HTTP，通过 POST 使用 JSON-RPC 2.0。 别名：https://tools-berry-mcp.edydaherz.workers.dev。

连接

Claude Code

claude mcp add --transport http tools-berry https://mcp.tools-berry.com

Claude.ai / Claude Desktop — 设置 → 连接器 → 添加自定义连接器，然后粘贴：

https://mcp.tools-berry.com

Cursor — 在 ~/.cursor/mcp.json 中（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "tools-berry": {
      "url": "https://mcp.tools-berry.com"
    }
  }
}

其他客户端 — 这是纯 JSON-RPC，因此可以使用 curl：

curl -s https://mcp.tools-berry.com \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"compute_take_home",
        "arguments":{"state":"ohio","salary":80000}}}'

该调用会算出俄亥俄州年薪 $80,000 的税后收入为 $63,294.38 — 与网站上对应页面显示的数字完全一致，精确到美分。

工具

工具	可回答的问题	必填参数
compute_take_home	某州薪资的完整工资明细：联邦所得税、Social Security、Medicare、州所得税、州工资税项目、年度／月度／双周税后收入、实际税率	state、salary
compute_bonus_withholding	奖金实际预扣税额：联邦 22% 补充税率（超过 $1,000,000 的部分按 37% 计算）、该州的奖金税务处理方式，以及 FICA	state、bonusAmount
compare_states	同一薪资在多个州的税后收入，按从高到低排名，并列出各州与最高者的差额	states、salary
get_state_rates	某州 2026 年的税率表：单一税率或税档、标准扣除额、雇员工资税项目、补充收入计税方式，以及这些数据所依据的法规	state

state 可接受州的全名（Ohio）、两字母代码（OH）或 slug（ohio、district-of-columbia）。所有工具的 filingStatus 均为可选参数，默认为 single；可接受 single、married、head_of_household 以及常见别名（mfj、mfs、hoh）。 每个响应都包含易读文本和一个原始数字组成的 structuredContent 对象。

在浏览器中试用

该端点会响应 GET 请求，因此无需客户端即可检查：

请求	返回内容
GET /	JSON 自我描述：服务信息、协议版本、说明、工具列表
GET /health	{"ok":true}
GET /?rpc=<url-encoded JSON-RPC request>	执行一条只读请求并返回 JSON-RPC 响应

?rpc= 形式只是用于冒烟测试的便捷方式，并非 MCP 的一部分。之所以提供它，是因为有些网络会屏蔽 *.workers.dev 或拦截 POST 探测请求；无法访问的服务与已宕机的服务无法区分。

curl -sG https://mcp.tools-berry.com \
  --data-urlencode 'rpc={"jsonrpc":"2.0","id":1,"method":"tools/list"}'

设计

• 不重复实现计算逻辑。 tools.js 直接导入 src/engine/paycheck-engine.js 和 src/engine/bonus-tax.js，并使用与公开页面相同的数据文件。不为 MCP 层重新推导任何数据；该层只负责整理输入、选择链接并格式化文本。test/test-mcp-server.js 会验证服务返回的答案与直接调用引擎所得结果在全部 51 个司法管辖区内均精确到美分，因此服务不会悄然偏离网站。
• 无依赖。 此处所需的协议接口包括 initialize、tools/list、 tools/call，以及 ping 和空的 resources/list / prompts/list 探测，因此直接在 mcp.js 中手动实现，而不引入 SDK。npm install 不执行任何操作；npm test 可直接在纯 Node 上运行。
• 无状态且只读。 无身份验证、无会话、无存储、无绑定、无写入。 不会保留你发送的任何内容。
• 速率限制： 每个 IP 每分钟 120 个请求。每次调用只需几微秒进行计算，因此此上限仅用于阻止失控的循环。
• 内置来源标注。 每个工具响应末尾都会附上来源行和指向 tools-berry.com 对应页面的深层链接，该页面展示相同的数值。

数字说明

2026 纳税年度，涵盖全部 50 个州及哥伦比亚特区。包括：联邦所得税、社会保障税和 Medicare 税（含额外的 0.9%）、州所得税，以及州级雇员工资税项目，例如 SDI 和 PFML。数据为预扣税估算值，假设只有一份工作、没有税前扣除，除标准扣除额外没有其他抵免。未计入地方和城市所得税。这不是税务建议，也不是已提交的纳税申报表。

get_state_rates 会返回一个 source 字段，注明各州数据所依据的法规或部门税率表，因此这里的任何数字都可以追溯来源。

来源和更新。 引擎和两个数据文件由 tools-berry.com 维护，并镜像到此代码库。托管服务部署自该网站自己的代码库，因此，此代码库是易于阅读和复用的副本，而非部署源。网站上的税率发生变化时，此处的镜像也会更新。如果需要确保使用的是最新数据，请调用托管端点。

引用

如果你在发布的内容中使用了这里的数据或代码，请注明来源为 tools-berry.com。这就是免费提供该引擎的全部商业模式。

自行部署

你不需要这样做——托管实例免费开放。但如果你想部署自己的副本：

npx wrangler deploy

它是一个单独的 Cloudflare Worker，无需绑定项，也无需密钥。wrangler.toml 中的自定义域名配置块已注释；取消注释并将其指向你控制的主机名，或者直接使用 wrangler 输出的 workers.dev URL。

许可证

MIT — 参见 LICENSE。版权所有 2026 Edmond Daher。