tools · POST /v1/tools/search_tax_rules

search_tax_rules

Does the corpus encode this? Rule discovery by keyword.

Call it

bash

curl -s https://opentax.invaro.ai/v1/tools/search_tax_rules \
  -H "Authorization: Bearer $OPENTAX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "kiddie tax",
  "asOf": "2025-12-31"
}'

What it does

Full-text search over the encoded tax-law corpus ('kiddie tax', 'NIIT threshold', 'california renters credit'). Returns matching rules: id, title, statutory citation, effective window, and a verbatim excerpt of the law text. A hit means the engine computes this; zero hits means it is outside the corpus — say so rather than guessing. Follow up with explain_rule for a hit's full formula, or lookup_tax_parameter for its dollar amounts.

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: query. Everything else is optional and defaults are disclosed in assumptions.

field	type	description
queryrequired	string	plain-English search, e.g. 'kiddie tax'
asOf	string	pattern ^\d{4}-\d{2}-\d{2}$
limit	integer	≥ 1 · ≤ 20

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.