Look up tax rates and rules
search_rulesLook up tax rates, thresholds and rules in one or many jurisdictions, such as 'VAT rates in MT, IE and DE', 'income tax brackets for 2025' or 'rules mentioning reverse charge'. Returns a bundled markdown rule set plus each jurisdiction's official source (official_source). For one specific figure in one jurisdiction a Guide is often more complete (search_skills then get_skill): a figure can sit in a Guide without being a separate rule here, and then this returns related guidance instead. Entries tagged GUIDANCE are text, not values. Figures are not certified current: confirm each against official_source and prefer it when they disagree. By default returns all matching rules, each tagged with its verification status; status:'verified' excludes draft, needs_update and unsure rules; it still includes research-verified (source-cited) rules, so it does not mean accountant-reviewed. list_rule_facets gives the valid filter values.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Free-text search over each rule's label, value, and citation. | |
| limit | No | Max rules to return (default 200, max 500). | |
| roles | No | Skill roles: foundation | compute | orchestrator | reference. | |
| topic | No | Filter by a fact topic. | |
| offset | No | Pagination offset — pass the previous response's next_offset. | |
| reason | No | One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional. | |
| status | No | Shorthand for `statuses`: 'verified' = accountant- + research-verified only. Default 'all'. | |
| domains | No | Accounting domains, e.g. ['vat-gst','income-tax']. See list_rule_facets. | |
| statuses | No | Verification statuses to include. Default = all (each rule is tagged). | |
| tax_year | No | Limit to a tax year, e.g. 2025. | |
| block_types | No | Rule kinds to include. Default = all of these (framing prose + workflow steps are excluded). | |
| jurisdictions | No | ISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | No | Total matching rules (across all pages). | |
| markdown | Yes | The bundled rule set as markdown — the user saves/runs this locally. | |
| truncated | No | ||
| fact_count | Yes | Rules returned on this page. | |
| next_action | No | ||
| next_offset | No | ||
| jurisdictions | No | ||
| accountant_verified_count | No |