COLA Insight MCP server
Commit Oct 18, 2026Provides read-only access to Social Security cost-of-living adjustment data, benefit calculations, and historical CPI-W tracking.
Also known as ge3m0r/colainsight-data, colainsight-data
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Oct 18, 2026
- License
- MIT
What is COLA Insight MCP?
COLA Insight provides read-only access to Social Security cost-of-living adjustment data, benefit calculations, and historical CPI-W tracking.
Summary generated from the project's README
About COLA Insight MCP server
COLA Insight provides an independent educational resource for tracking Social Security cost-of-living adjustment data. It offers read-only access to 2027 COLA forecasts, historical CPI-W tracking, and benefit-impact tables ranging from $100 to $5,000. This tool is designed for developers and researchers who need to verify or reuse Social Security data through structured formats like JSON or CSV.
Users can connect an AI assistant to the remote Streamable HTTP endpoint without needing an API key. The MCP server includes four specific tools to access the current COLA record, educational benefit calculations, preserved snapshot history, and primary sources. It distinguishes itself by providing clear data status definitions, labeling records as forecast, computed, or official to ensure users do not mistake estimates for government announcements.
This project is not affiliated with the Social Security Administration or any other government agency. It functions as a public data layer that pulls from primary sources like the BLS Public Data API and FRED to provide independent verification of economic trends.
What you can do with it
- 1Analyze benefit impactAsk the AI to retrieve a table showing how different benefit amounts will be affected by the upcoming adjustment.
Written from the project's README. Every use case is checked against a quote from it.
How to install COLA Insight MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall COLA Insight MCP in Claude Code
$ claude mcp add --transport http colainsight-data https://www.colainsight.com/mcpInstall COLA Insight MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"colainsight-data": {
"url": "https://www.colainsight.com/mcp"
}
}
}Install COLA Insight MCP in VS Code
.vscode/mcp.json
{
"servers": {
"colainsight-data": {
"type": "http",
"url": "https://www.colainsight.com/mcp"
}
}
}Install COLA Insight MCP in VS Code CLI
$ code --add-mcp '{"name":"colainsight-data","type":"http","url":"https://www.colainsight.com/mcp"}'Install COLA Insight MCP in Codex
$ codex mcp add colainsight-data --url https://www.colainsight.com/mcpInstall COLA Insight MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.colainsight-data] url = "https://www.colainsight.com/mcp"
Install COLA Insight MCP in Gemini CLI
$ gemini mcp add -s user --transport http colainsight-data https://www.colainsight.com/mcpInstall COLA Insight MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"colainsight-data": {
"url": "https://www.colainsight.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablege3m0r/colainsight-data is public and reachablegithub.com/ge3m0r/colainsight-data ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-18github.com/ge3m0r/colainsight-data ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 495 msPass
README
View on GitHubCOLA 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
| Asset | Permanent URL |
|---|---|
| Current JSON record | colainsight.com/api/cola |
| Snapshot history CSV | 2027 COLA history CSV |
| Benefit amount CSV | 2027 benefit amounts CSV |
| Zenodo dataset | Latest version (concept DOI) |
| Archived version 2026.10.16 | 10.5281/zenodo.23431339 |
| Preserved revision timeline | 2027 COLA forecast history |
| CPI-W chart | 2027 COLA CPI-W chart |
| Benefit increase chart | 2027 COLA increase chart |
| Embeddable tracker | Free 2027 COLA widget |
| Interactive calculator | 2027 COLA calculator |
| MCP documentation | Connect to COLA Insight MCP |
| MCP endpoint | https://www.colainsight.com/mcp |
| Official MCP Registry | io.github.ge3m0r/cola-insight |
| Smithery directory | ge3m0r/cola-insight |
| Glama connector | io.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:
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:
<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:
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
- BLS Public Data API — CPI-W series
CWUR0000SA0 - SSA latest COLA determination
- CMS Medicare premiums and deductibles
- FRED CPI-W series — retrieval fallback and cross-check
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 support@colainsight.com.
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.
COLA Insight MCP questions
How do I add COLA Insight MCP to Claude Code?
Run claude mcp add --transport http colainsight-data https://www.colainsight.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add COLA Insight MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is this data an official announcement from the Social Security Administration?
No, the project is independent and not affiliated with the SSA or any U.S. government agency.
What are the different data status definitions?
Records are categorized as 'forecast' (independent estimate), 'computed' (statutory formula reproduced but SSA confirmation pending), or 'official' (SSA has published the COLA).
Do I need an API key to use the MCP server?
No, the MCP server is public and does not require an API key.