关于 Social Security COLA 2027 MCP
面向估算 COLA 调整、退休年龄和福利限额的用户,提供 Social Security 信息查询服务。它结合年度数据与 SSA 退休规则,计算不同申领年龄的福利调整及收入测试扣减。
主要功能
- 01COLA 数值及历史记录
- 02月福利增长额计算
- 03按出生日期查询完全退休年龄
- 04估算不同申领年龄的福利
- 05收入限额及扣减计算
适用场景
- 01估算 COLA 调整后的福利
- 02查询退休年龄及 62 岁申领减额
- 03比较不同申领年龄的福利
- 04计算收入测试扣减额
MCP 相关
向 MCP 客户端提供 Social Security 查询与计算工具,数据来源包括 Federal Register 通知和 20 CFR 规则。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcpclaude mcp add --transport http theluckystrike-social-security-cola-2027 https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp{"mcpServers":{"theluckystrike-social-security-cola-2027":{"type":"http","url":"https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp"}}}在 Cursor 中打开{"servers":{"theluckystrike-social-security-cola-2027":{"type":"http","url":"https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"theluckystrike-social-security-cola-2027":{"type":"http","url":"https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp"}}}{"mcpServers":{"theluckystrike-social-security-cola-2027":{"serverUrl":"https://social-security-cola-2027-mcp.lipmichal.workers.dev/mcp"}}}命令在终端中运行;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_increase | COLA 调整后的月福利金额,按 SSA 规则四舍五入至 10 美分和整美元。 |
get_full_retirement_age | 指定出生日期对应的完全退休年龄、达到该年龄的日期和月份、最早可在 62 岁申领的月份、62 岁申领时的减额百分比、配偶福利百分比、延迟至 70 岁申领的增额,以及遗属完全退休年龄。 |
calculate_claiming_age_benefit | 根据完全退休年龄福利金额(PIA),计算 62 至 70 岁任意申领年龄对应的月福利金额。 |
get_social_security_limits | 2023 至 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。
- 2027 年生活成本调整及其他决定,《联邦公报》,2026-10-26,以及早些年份的通知。
- 20 CFR 404.409 完全退休年龄,404.410 减额,404.313 延迟退休积分,404.102 年龄,404.311 首个领取月份。
限制
- 本工具不会读取您的收入记录。请使用 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
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。