COLA Insight

io.github.ge3m0r由 GitHub 帳號 ge3m0r 發布v1.0.1更新於 Oct 24, 2026

Read-only Social Security COLA data, calculations, history, and official source links.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

唯讀的遠端 MCP 伺服器，提供 COLA Insight 追蹤的 2027 年社會安全 COLA 比率、福利變化估算、快照歷史與來源連結。

可以做什麼
  • 讀取最新的 2027 年 COLA 狀態、比率、CPI-W 觀測值、時間戳與主要來源連結
  • 依最新追蹤比率估算每月與每年的福利變化
  • 依時間倒序取得保留的預測、公式推算與官方 COLA 快照
  • 查詢資料所用的政府來源、方法說明、資料字典與公開資料集
適用情境
適合需要回答 2027 年社會安全生活成本調整相關問題、呈現福利金額可能的變化，或查核資料歷史與來源的情境。它是獨立的教育性專案，並非 SSA 官方服務。
執行需求
需要遠端 Streamable HTTP 端點；無需 API 金鑰、環境變數或請求標頭。需要能連線至服務提供者的網站。
安裝前請注意
福利變化結果為教育性估算，不構成 SSA 的福利核定；預測或公式推算的紀錄不得表述為 SSA 官方公告。此專案獨立運作，與 SSA、BLS、CMS 及美國政府無隸屬關係。所有工具皆為唯讀。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 COLA Insight，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.ge3m0r%2Fcola-insight/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "cola-insight": {
      "type": "http",
      "url": "https://www.colainsight.com/mcp"
    }
  }
}

README

COLA Insight Data

Open data, calculation notes, charts, and an embeddable widget for tracking the 2027 Social Security cost-of-living adjustment (COLA).

Live project: COLA Insight
Current forecast and CPI-W tracker: 2027 Social Security COLA forecast
Public asset library: Data, charts, downloads, and widget

Archived dataset: Latest Zenodo record · Version 2026.10.16

Public MCP server: Connect an AI assistant

Official Registry: io.github.ge3m0r/cola-insight

COLA Insight is an independent educational project. It is not affiliated with, endorsed by, or operated by the Social Security Administration (SSA), Bureau of Labor Statistics (BLS), Centers for Medicare & Medicaid Services (CMS), or the U.S. government.

What is in this repository

This repository publishes the parts of COLA Insight that are most useful for independent verification and reuse:

  • preserved 2027 COLA forecast and calculation snapshots;
  • a complete benefit-impact table from $100 through $5,000;
  • the public JSON data contract and an example record;
  • calculation methodology and status definitions;
  • publication-ready SVG charts;
  • a copy-and-paste version of the live COLA widget;
  • public MCP distribution metadata and connection documentation.

The production website, Cloudflare Worker deployment, D1 configuration, scheduled refresh system, rate limiting, analytics, and editorial/SEO application source are intentionally maintained separately.

Current public endpoints

AssetPermanent URL
Current JSON recordcolainsight.com/api/cola
Snapshot history CSV2027 COLA history CSV
Benefit amount CSV2027 benefit amounts CSV
Zenodo datasetLatest version (concept DOI)
Archived version 2026.10.1610.5281/zenodo.23431339
Preserved revision timeline2027 COLA forecast history
CPI-W chart2027 COLA CPI-W chart
Benefit increase chart2027 COLA increase chart
Embeddable trackerFree 2027 COLA widget
Interactive calculator2027 COLA calculator
MCP documentationConnect to COLA Insight MCP
MCP endpointhttps://www.colainsight.com/mcp
Official MCP Registryio.github.ge3m0r/cola-insight
Smithery directoryge3m0r/cola-insight
Glama connectorio.github.ge3m0r/cola-insight

The files in this repository are publishable snapshots. The permanent URLs above are the authoritative, automatically updated versions.

Data status matters

Every record uses exactly one status:

  • forecast — an independent estimate while one or more required Q3 CPI-W observations are unavailable;
  • computed — all three observations are available and the statutory formula can be reproduced, but SSA confirmation is still pending;
  • official — SSA has published the benefit-year COLA.

Do not describe a forecast or computed record as an official SSA announcement.

See methodology/status-definitions.md and schema/data-dictionary.md before reusing the data.

Quick examples

Fetch the current record:

js
const response = await fetch("https://www.colainsight.com/api/cola");const record = await response.json();
console.log(record.status, record.rate.displayed);

Embed the live tracker:

html
<iframe  src="https://www.colainsight.com/embed/2027-cola"  title="2027 Social Security COLA tracker by COLA Insight"  width="100%"  height="430"  style="border:0;max-width:720px"  loading="lazy"></iframe>

Connect an MCP-compatible assistant using the remote Streamable HTTP endpoint:

text
https://www.colainsight.com/mcp

The MCP server is public, read-only, and requires no API key. It provides four tools for the current COLA record, educational benefit calculations, preserved snapshot history, and primary sources. See mcp/README.md for the tool list, example configuration, privacy guidance, and versioning policy.

Primary sources

The source used to retrieve each stored observation is included with the record. A fallback changes the retrieval path, not the underlying BLS series.

Citation

Suggested citation for the archived 2026.10.16 dataset:

COLA Insight. (2026). COLA Insight 2027 Social Security COLA Dataset: CPI-W History and Benefit Amount Table (Version 2026.10.16). Zenodo. https://doi.org/10.5281/zenodo.23431339

Use the concept DOI when linking to the latest available version, and the version DOI when citing this exact release.

For machine-readable citation metadata, see CITATION.cff. Questions and corrections can be sent to [email protected].

Licensing

  • Example code and widget snippets: MIT License
  • Original documentation, charts, and explanatory content: CC BY 4.0
  • Government facts and source data may have their own public-domain or agency terms; attribution to the responsible agency should be preserved.
  • The COLA Insight name and logo are not granted for reuse as a product identity. See TRADEMARKS.md.

Attribution is appreciated and helps readers verify freshness, but no specific keyword-rich anchor text is required.

來源：README.md，提交 ca03675

工具

4

get_current_cola

Get current Social Security COLA data

Return the latest tracked 2027 Social Security COLA status, rate, CPI-W observations, timestamp, and primary source links.

無需輸入參數。

calculate_benefit_change

Calculate a COLA benefit change

Estimate the monthly and annual benefit change using COLA Insight's latest tracked rate. This is an educational estimate, not an SSA benefit determination.

輸入參數medicarePartBPremiumcurrentMonthlyBenefit必填

get_cola_history

Get preserved COLA history

Return preserved forecast, formula-derived, and official COLA snapshots in reverse chronological order.

輸入參數limit

get_cola_sources

Get COLA primary sources

Return the government sources, methodology, data dictionary, and public datasets used by COLA Insight.

無需輸入參數。

版本歷史

1
  1. v1.0.1最新Oct 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分