Private, independent site — not affiliated with any government agency.
GMB

Developers

Gov Money Benefits exposes four developer surfaces: an MCP server for AI assistants, public versioned rule packs, embeddable calculator widgets, and llms.txt. Everything is backed by the same verified data our own calculators use — every response and every pack carries its provenance.

MCP server

Streamable-HTTP Model Context Protocol endpoint:

https://api.cosyslabs.com/govmoneybenefits/mcp

Eight tools are available. Every tool response cites the rule pack it computed from — packId, verifiedDate, and the official sourceUrl — so agents can show users exactly where each figure comes from.

  • fers_annuity_estimateFERS annuity from high-3, service years, and retirement age (1%/1.1% multipliers, MRA+10 reduction)
  • tsp_projectionTSP balance projection with agency auto/match tiers and verified contribution limits
  • gs_pay_lookupExact GS pay for any grade, step, and locality from the official OPM tables
  • va_combined_ratingVA combined disability rating with correct rounding and the bilateral factor
  • va_monthly_compensationMonthly VA compensation for a rating and dependent situation, by effective year
  • ssdi_estimateSSDI benefit estimate via the real AIME → PIA bend-point formula
  • bah_lookupBAH rate by military housing area, pay grade, and dependency status
  • snap_screenSNAP eligibility pre-screen using USDA income tests, deductions, and allotments by state

See the MCP quickstart for Claude Desktop and ChatGPT setup.

Public rule packs

Every changing figure on this site (GS pay tables, VA compensation rates, TSP/IRS limits, SSA bend points, BAH rates, SNAP thresholds) lives in a versioned JSON rule pack, published read-only:

https://govmoneybenefits.com/rulepacks/index.json   — pack directory
https://govmoneybenefits.com/rulepacks/<packId>.json — individual packs

Each pack includes provenance fields: packId, effectiveYear, sourceUrl (the official agency document it was transcribed from), verifiedDate, and status (verified or update-pending). If you consume a pack, honor status — stale data should fail loud, not silently.

llms.txt

AI crawlers and agents should start at /llms.txt, which maps the site’s tools, rule packs, and compliance notes in a machine-friendly format.

Embeddable widgets

Embed any calculator with a single iframe using the /embed/<slug> pattern:

<iframe
  src="https://govmoneybenefits.com/embed/fers-retirement-calculator"
  width="100%"
  height="620"
  style="border:none;border-radius:12px"
  title="FERS Retirement Calculator"
></iframe>

No API key required.

Attribution requirements

  • Embeds include an attribution link back to govmoneybenefits.com — it must remain visible and unmodified.
  • If you republish figures from our rule packs, cite both the official agency source (sourceUrl) and this site as the transcription source.
  • Bulk scraping or redistribution of the site or rule packs without written permission is not allowed — ask us instead.
  • Anything you build on this data inherits our framing: estimates only, not legal, financial, or benefits advice, and only the responsible agency can determine an actual benefit.

Contact

Integration or partnership inquiries: [email protected]