mcpField
S
Social Security COLA 2027 MCP

Social Security COLA 2027 MCP

远程服务
github.com/theluckystrike其他01 天前更新
代码仓库

关于 Social Security COLA 2027 MCP

面向估算 COLA 调整、退休年龄和福利限额的用户,提供 Social Security 信息查询服务。它结合年度数据与 SSA 退休规则,计算不同申领年龄的福利调整及收入测试扣减。

主要功能

  1. 01COLA 数值及历史记录
  2. 02月福利增长额计算
  3. 03按出生日期查询完全退休年龄
  4. 04估算不同申领年龄的福利
  5. 05收入限额及扣减计算

适用场景

  1. 01估算 COLA 调整后的福利
  2. 02查询退休年龄及 62 岁申领减额
  3. 03比较不同申领年龄的福利
  4. 04计算收入测试扣减额

MCP 相关

向 MCP 客户端提供 Social Security 查询与计算工具,数据来源包括 Federal Register 通知和 20 CFR 规则。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

social-security-cola-2027-mcp

面向 AI 助手的 Social Security COLA 2027、完全退休年龄和 2027 年限额。2027 年 1 月发放的 COLA 为 3.6%。提供出生日期,即可得出确切的完全退休年龄月份、62 岁时的减额和 70 岁时的增额。

这是一个 Model Context Protocol (MCP) 服务。所有金额均摘自 Federal Register 中的 SSA 通知和 20 CFR 第 404 部分。无需 API 密钥。

工具

工具返回内容
get_social_security_cola指定发放年份的 COLA(2027 年为 3.6%,自 2026 年 12 月起生效,于 2027 年 1 月发放),以及自 1996 年起的历史记录。未指定年份时,会查询 Federal Register API,检查是否有更新的通知。
calculate_cola_increaseCOLA 调整后的月福利金额,按 SSA 规则四舍五入至 10 美分和整美元。
get_full_retirement_age指定出生日期对应的完全退休年龄、达到该年龄的日期和月份、最早可在 62 岁申领的月份、62 岁申领时的减额百分比、配偶福利百分比、延迟至 70 岁申领的增额,以及遗属完全退休年龄。
calculate_claiming_age_benefit根据完全退休年龄福利金额(PIA),计算 62 至 70 岁任意申领年龄对应的月福利金额。
get_social_security_limits2023 至 2027 年的最高应税收入(2027 年为 $192,300)、收入测试限额(2027 年为 $25,560 和 $67,920)、每个工作积分对应的收入、SGA、试工作月份、SSI 联邦最高金额和 PIA 弯折点。
calculate_earnings_test计算某一年的退休收入测试扣留金额和年度收入。

每项结果都包含结构化 JSON、一段摘要、as_of、source(Federal Register 通知或 eCFR 条款),以及 more(mcpstamp.com 上的页面)。

你的模型不知道但它了解的内容

  • 2027 年 COLA(3.6%)及 2027 年各项金额。SSA 于 2026-10-26 发布了这些信息,晚于大多数模型的训练时间。
  • 按原文规定的完全退休年龄规则。出生日期为 1 月 1 日的人按前一年计算。达到某个年龄的日期是生日的前一天。未达到完全退休年龄时,必须在整个月内满 62 岁才能申领,因此大多数人会在年满 62 岁后的下一个月开始申领。
  • 按 SSA 规则进行的精确减额和延迟申领增额计算。20 CFR 404.410 和 404.313 中的两个计算示例是测试用例。

安装

托管版(Claude.ai 自定义连接器、ChatGPT 开发者模式)

粘贴此 URL。无需令牌,无需注册。现在即可使用。

https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp
Claude Code
claude mcp add --transport http ss-cola https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp
Claude Desktop

Claude Desktop 可在 Settings、Connectors、Add custom connector 下添加远程服务。粘贴上面的 URL。

Cursor

添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ss-cola": { "url": "https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp" }
  }
}
VS Code

添加到 .vscode/mcp.json:

{
  "servers": {
    "ss-cola": { "type": "http", "url": "https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp" }
  }
}
本地 stdio(npm 发布后)

npm 包尚未发布。发布后,可使用 Node 20 或更高版本在本地运行:

claude mcp add ss-cola -- npx -y social-security-cola-2027-mcp

示例提示词

  • “2027 年 Social Security COLA 是多少?”
  • “我的月福利是 $2,008。2027 年 1 月会变成多少?”
  • “我出生于 1960 年 7 月 15 日。我的完全退休年龄是多少?如果我从 62 岁开始申领,会少领多少?”
  • “我的 PIA 是 $2,400。如果我在 64 岁零 6 个月或 70 岁时申领,能领多少?”
  • “2027 年 Social Security 收入限额是多少?如果我收入 $40,000,会扣留多少?”
  • “2027 年 Social Security 的最高应税收入是多少?”

数据来源

完整列表及获取日期见 DATA_SOURCES.md。

限制

  • 本工具不会读取您的收入记录。请使用 SSA 对账单查看您的 PIA。
  • 根据净付款估算 COLA 增幅,误差约为 1 美元,因为 SSA 会先对 PIA 应用 COLA,再扣除 Medicare 保费。
  • 配偶和遗属金额仅以百分比显示。家庭最高限额和残障福利未纳入模型。
  • 年度限额涵盖 2023 至 2027 年。COLA 历史涵盖 1996 至 2027 年。

更多

更多能回答助手无法独自解答的问题的 MCP 服务,请访问 mcpstamp.com。

属于 Zovo MCP 系列:https://mcp.zovo.one

由 theluckystrike 构建。

开发

npm install
npm test                              # builds, then runs the fixture tests and an offline stdio test
node scripts/stdio-transcript.mjs     # stdio round trip, writes .live/stdio-transcript.jsonl

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。