tools · POST /v1/tools/is_tipped_occupation

is_tipped_occupation

Whether a job is on the Treasury § 224 tipped-occupation list.

Call it

bash

curl -s https://opentax.invaro.ai/v1/tools/is_tipped_occupation \
  -H "Authorization: Bearer $OPENTAX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "job": "bartender"
}'

What it does

Determine whether a job is on the Treasury Tipped Occupation list (Treas. Reg. § 1.224-1, final Apr 2026) for the § 224 'no tax on tips' deduction. Fuzzy-matches the job name; returns the official listing (name, TTC code, category) or a definitive 'not listed'.

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

field	type	description
jobrequired	string	e.g. "bartender", "software engineer", "DJ"

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.