# Verified Numbers [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/jfortier93/verified-numbers-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/verified-numbers

## Description
Current source-cited 2026 US tax constants and calculators for AI agents; every answer cites IRS.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "verified-numbers": {
    "command": "npx",
    "args": ["-y","mcpize"]
  }
}
```

## Documentation & README

[![MCPize](https://mcpize.com/badge/@josh/verified-numbers)](https://mcpize.com/mcp/verified-numbers)

# 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)

```bash
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

```bash
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")
```

```json
{
  "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)

| Constant set | Primary source |
|---|---|
| Mileage H1 2026 | IRS Notice 2026-10 (IR-2025-128, Dec 29 2025) |
| Mileage H2 2026 | IRS Announcement 2026-11, IRB 2026-29 (Jul 13 2026) |
| Brackets & standard deduction | IRS Rev. Proc. 2025-32 (Oct 9 2025) + OBBBA §70103 |
| Retirement limits | IRS Notice 2025-67 (IR-2025-111, Nov 13 2025) |
| SS wage base $184,500 | SSA COLA announcement (Oct 24 2025) |
| Estimated-tax rules | Form 1040-ES (2026); IRC §6654 |

## 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