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_estimate— FERS annuity from high-3, service years, and retirement age (1%/1.1% multipliers, MRA+10 reduction)tsp_projection— TSP balance projection with agency auto/match tiers and verified contribution limitsgs_pay_lookup— Exact GS pay for any grade, step, and locality from the official OPM tablesva_combined_rating— VA combined disability rating with correct rounding and the bilateral factorva_monthly_compensation— Monthly VA compensation for a rating and dependent situation, by effective yearssdi_estimate— SSDI benefit estimate via the real AIME → PIA bend-point formulabah_lookup— BAH rate by military housing area, pay grade, and dependency statussnap_screen— SNAP 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]