Verified Numbers MCP Server

Verified Numbers MCP

Current, source-cited US federal tax and business constants for AI agents — tax year 2026.

Why this exists

AI models recall tax numbers from training data, and training data goes stale. Live example: the IRS made a rare mid-year mileage adjustment effective July 1, 2026 (business rate 72.5¢ → 76¢/mile, Announcement 2026-11). Any model trained before July 2026 confidently reports the wrong current rate. Agents doing bookkeeping, invoicing, or planning work need verified numbers, not remembered ones. Every response from this server carries its primary source and a last-verified date.

Tools (9)

• get_mileage_rate(date, purpose) — IRS standard mileage rate in effect on a specific date; handles both 2026 periods
• mileage_deduction(miles, date, purpose) — dollar deduction at the correct period rate

Connect via MCPize (hosted)

npx -y mcpize connect @josh/verified-numbers --client claude

Or add the HTTP endpoint directly: https://verified-numbers.mcpize.run

Marketplace page: https://mcpize.com/mcp/verified-numbers

• se_tax_estimate(net_self_employment_profit, filing_status) — 2026 SE tax with wage-base cap and Additional Medicare
• federal_income_tax(taxable_income, filing_status) — progressive tax via Rev. Proc. 2025-32 brackets
• standard_deduction(filing_status, age_65_or_older, blind) — 2026 amounts with additions
• quarterly_estimate(...) — simplified federal quarterly estimated-tax calc with optional safe-harbor comparison
• retirement_limits() — 2026 401(k)/IRA/SEP/SIMPLE/HSA limits and catch-up rules
• estimated_tax_deadlines() — 2026 quarterly due dates
• data_provenance() — how and when every constant was verified

Design principles

1. Refuse rather than guess. Filing statuses or dates outside verified data raise errors (e.g., MFS brackets are absent in v1 and the server says so).
2. Every response is cited — primary source + last_verified date + disclaimer, in the payload itself.
3. Deterministic. No LLM calls, no external requests at runtime. Pure lookup and arithmetic. Sub-millisecond, zero marginal cost.

Run

pip install "mcp>=2.0"
python server.py          # stdio transport

Tests: python test_server.py — hand-computed expected values for every calculator.

Example

Ask any model trained before July 2026 for the current IRS business mileage rate. It will say 72.5 cents. Then call:

get_mileage_rate("2026-08-01")

{
  "date": "2026-08-01",
  "purpose": "business",
  "cents_per_mile": 76.0,
  "effective_period": "2026-07-01 to 2026-12-31",
  "source": "IRS Announcement 2026-11, IRB 2026-29 (rare mid-year adjustment, announced Jul. 13, 2026)",
  "last_verified": "2026-07-28",
  "disclaimer": "Educational reference data and estimates only. Not tax, legal, or financial advice."
}

Every tool responds in this shape: the number, the effective window, the primary source, and the verification date.

Data provenance (verified 2026-07-28)

Maintenance SOP (the moat)

Quarterly, and within 7 days of any IRS newsroom announcement:

1. Check irs.gov/newsroom for rate changes (search: mileage, inflation adjustment, notice)
2. Check SSA press releases each October (wage base, COLA)
3. Check IRS retirement-limit notice each November
4. Update constants_2026.json, bump last_verified, run test_server.py, republish
5. Each December: create constants_<year+1>.json and add year routing

Estimated effort: ~1 hour/quarter. This maintenance commitment is the product — competitors that stop updating die.

Compliance posture

• Educational reference and estimates only; not tax, legal, or financial advice — stated in every response payload
• Federal only; no state/local tax
• Underlying data is US-government material (public domain); no scraped or licensed content
• Simplifications are disclosed in-payload (QBI phase-outs, credits, W-2 interactions not modeled)

Pricing

• Free tier: 50 requests/month (enough to evaluate every tool)
• Then $0.01 per request, metered. Pay only for what you use
• Fiat rails only (Stripe via marketplace payouts)

Roadmap

v1.1: MFS brackets, capital-gains thresholds · v1.2: state income-tax constants (top 10 states) · v2: 2027 constants + year routing