tools · POST /v1/tools/verify_tax_claim

verify_tax_claim

Verified or refuted, with the correct value.

Call it

bash

curl -s https://opentax.invaro.ai/v1/tools/verify_tax_claim \
  -H "Authorization: Bearer $OPENTAX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "facts": {
    "filing": {
      "filingStatus": "mfj"
    },
    "income": {
      "wages": 120000
    },
    "credits": {
      "qualifyingChildren": 2
    },
    "asOf": "2025-12-31"
  },
  "claimedAmount": 5746
}'

What it does

Verify a claimed tax amount (yours, a user's, or another tool's) against the law. Returns verdict 'verified' or 'refuted' with the correct value. Use this as a self-check before presenting any tax number. Put asOf (and target, if any) INSIDE the facts object — e.g. facts: {..., "asOf": "2025-12-31"} — otherwise the claim is checked under today's law.

This is the description the MCP server hands to a model. The imperative sentences are addressed to the model; the facts about scope apply to every caller.

Inputs

Required: facts, claimedAmount. Everything else is optional and defaults are disclosed in assumptions.

field	type	description
factsrequired	object · any keys	facts for the computation: either flat corpus fact ids (see list_input_facts) or the same group objects calculate_tax accepts (filing, income, retirement, …), plus optional target and asOf. Business/fiduciary/dependent facts are accepted flat. Unknown keys are rejected by name — nothing is ever silently dropped. Takes every field listed on calculate_tax, grouped or flat, plus asOf and target.
claimedAmountrequired	number \| string	the amount to verify (negative = refund)
toleranceDollars	number	default 1 ≥ 0

Example

No captured example for this tool yet; the call above is a valid request. The examples page has ten end-to-end pairs including two refusals.