search_rules
ActiveTool of OpenAccountants
Query individual tax RULES/FACTS (rates, thresholds, rules, definitions, tables) ACROSS jurisdictions and metadata, and get back a bundled markdown rule set the user can save and run locally. Unlike get_skill (one whole skill), this assembles a cross-cutting SET — e.g. 'VAT rates in MT, IE and DE', 'all income-tax thresholds for 2025', or 'rules mentioning reverse charge'. By default returns ALL matching rules, each tagged with its verification status; pass status:'verified' for accountant-/research-verified only. Call `list_rule_facets` first to see the queryable values.
Parameters schema
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Free-text search over each rule's label, value, and citation."
},
"limit": {
"type": "integer",
"description": "Max rules to return (default 200, max 500)."
},
"roles": {
"type": "array",
"items": {
"type": "string"
},
"description": "Skill roles: foundation | compute | orchestrator | reference."
},
"topic": {
"type": "string",
"description": "Filter by a fact topic."
},
"offset": {
"type": "integer",
"description": "Pagination offset — pass the previous response's next_offset."
},
"status": {
"enum": [
"all",
"verified"
],
"type": "string",
"description": "Shorthand for `statuses`: 'verified' = accountant- + research-verified only. Default 'all'."
},
"domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "Accounting domains, e.g. ['vat-gst','income-tax']. See list_rule_facets."
},
"statuses": {
"type": "array",
"items": {
"enum": [
"draft",
"research_verified",
"accountant_verified",
"needs_update",
"unsure"
],
"type": "string"
},
"description": "Verification statuses to include. Default = all (each rule is tagged)."
},
"tax_year": {
"type": "integer",
"description": "Limit to a tax year, e.g. 2025."
},
"block_types": {
"type": "array",
"items": {
"enum": [
"rate",
"threshold",
"rule",
"formula",
"refusal_code",
"definition",
"table_ref",
"table"
],
"type": "string"
},
"description": "Rule kinds to include. Default = all of these (framing prose + workflow steps are excluded)."
},
"jurisdictions": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
OpenAccountants
https://github.com/openaccountants/openaccountants
2/7 registries