cpi-inflation-calculator-mcp

cpi-inflation-calculator-mcp

An MCP server that gives an AI assistant the official U.S. Consumer Price Index from the Bureau of Labor Statistics, from 1913 to the latest published month, so it can adjust any dollar amount for inflation, report the current inflation rate, check whether a raise kept pace, and compute the Social Security COLA. It checks the BLS API live for months newer than its training data.

Hosted endpoint, no sign-in and no token:

https://cpi-inflation-calculator-mcp.lipmichal.workers.dev/mcp

Tools

Every result has structured JSON, a plain-English summary, data_status (live or bundled, latest month), as_of, source (the BLS series) and more (a pay raise calculator on statewage.com).

What it knows that your model does not

• CPI index values through September 2026 (CPI-U 336.940), with a live check for anything newer.
• Inflation was 3.7% over the 12 months to September 2026 (CPI-U, not seasonally adjusted). Core CPI was 2.6%.
• BLS published no October 2025 CPI. Data were not collected during the 2025 lapse in appropriations. The tools say so instead of inventing a value, and still use the official 2025 annual average (321.943, 2.6% inflation).
• The 2027 Social Security COLA is 3.6%. The tool reproduces it from Q3 2026 CPI-W (average 328.746 against 317.265), and also reproduces 2023 to 2026.

Install

Claude.ai custom connector or ChatGPT developer mode

Add a custom connector and paste the URL. No token is needed.

https://cpi-inflation-calculator-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http cpi-inflation https://cpi-inflation-calculator-mcp.lipmichal.workers.dev/mcp

Or run it locally:

claude mcp add cpi-inflation -- npx -y github:theluckystrike/cpi-inflation-calculator-mcp

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "cpi-inflation": {
      "command": "npx",
      "args": ["-y", "github:theluckystrike/cpi-inflation-calculator-mcp"]
    }
  }
}

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cpi-inflation": {
      "url": "https://cpi-inflation-calculator-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "cpi-inflation": {
      "type": "http",
      "url": "https://cpi-inflation-calculator-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

Node 20 or newer is needed for the local npx version. Optional: set BLS_API_KEY to a free BLS registration key for a higher live-data quota.

Example prompts

• "What is $1,000 from 2000 worth today?"
• "What is the current inflation rate, and what was core inflation?"
• "What was inflation in 2025? Was any month missing?"
• "My salary went from $60,000 in January 2025 to $63,000 now. Did I beat inflation?"
• "How is the 2027 Social Security COLA calculated?"
• "Convert $50 in 1970 to 2026 dollars using CPI-W."

Data sources

U.S. Bureau of Labor Statistics CPI series CUUR0000SA0, CWUR0000SA0 and CUUR0000SA0L1E, fetched from the BLS Public Data API on 2026-11-03, plus a live check on each call. The COLA rule is 42 U.S.C. 415(i). See DATA_SOURCES.md.

Limitations

• General information, not financial advice.
• U.S. city average, not seasonally adjusted. No regional or item-level indexes (food, rent, gas).
• The keyless BLS API caps daily requests per IP address. When the cap is hit, the hosted server answers from bundled data through September 2026 and says so in data_status.
• Periods with no annual average yet (the current year) use the latest month of that year, with a note.

More

Check a raise after taxes with the pay raise calculator and the Social Security tax calculator on statewage.com.

Part of the Zovo MCP collection: https://mcp.zovo.one

Development

npm install
npm run build
npm test

src/core.ts holds the CPI math and has no I/O. src/data.ts is the bundled BLS data. src/live.ts checks the BLS API for newer months. src/stdio.ts is the local entry and src/worker.ts is the Cloudflare Worker entry. Both use the same tool registry in src/tools.ts.

License

MIT

More data servers from the same author

Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.

The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one