OpenAccountants

 ⟨198 unchanged words⟩ this skill ({name, profile_url}), when ita isnamed accountant-authored;approved accountant authored it; null otherwise.","type":["object"," ⟨6 unchanged words⟩ 

 ⟨84 unchanged words⟩ },"tier":{"description":"1 = accountant-verifiedaccountant-checked, 2 = research-verifiednot independently checked","type":"integer"},"verification":{ ⟨32 unchanged words⟩ 

Read more sections of a Guideskill

 ⟨8 unchanged words⟩ ,"title":"Read more sections of a Guideskill"}

 ⟨11 unchanged words⟩  [country]?'. Returns every jurisdiction with published Guidesskills (countries as ISO 2, US states as US-XX, Canadian provinces) with Guideskill counts, accountant-reviewed counts and the named lead  ⟨5 unchanged words⟩ 

Browse tax Guidesskills

Browse the Guidesskills for one jurisdiction or domain (for example every Guideskill for 'MT', or every 'payroll' Guideskill), each with its quality tier and verification ⟨31 unchanged words⟩ 

 ⟨6 unchanged words⟩ ,"readOnlyHint":true,"title":"Browse tax Guidesskills"}

 ⟨44 unchanged words⟩ For one specific figure in one jurisdiction a Guideskill is often more complete (search_skills then get_skill): a figure can sit in a Guideskill without being a separate rule here, and  ⟨66 unchanged words⟩ 

Search tax Guidesskills by topic

Find the Guideskill for a specific tax topic by keyword:  ⟨22 unchanged words⟩ limit to one jurisdiction or domain. Returns matching Guideskill slugs to open with get_skill. Set content_type='method' to ⟨12 unchanged words⟩ 

{"properties":{"content_type":{"description":"What kind of Guideskill to find. 'method' = step-by-step procedures you EXECUTE ⟨7 unchanged words⟩  omitted = reference material (rates/thresholds/rules). A Guideskill can be either or both.","enum": ⟨66 unchanged words⟩ 

 ⟨6 unchanged words⟩ ,"readOnlyHint":true,"title":"Search tax Guidesskills by topic"}

 ⟨38 unchanged words⟩ or via `skill_slug` a bug in a specific Guideskill). Anonymize hard: no names, amounts,  ⟨139 unchanged words⟩ 

 ⟨138 unchanged words⟩ when the note is feedback about a SPECIFIC Guideskill, by its slug (e.g. 'us-sales-tax'). Replaces ⟨39 unchanged words⟩ 

 ⟨97 unchanged words⟩ clear and says so in `jurisdiction_source`. Returns the Guidesskills to read next (`skills_to_load`, open each with ⟨6 unchanged words⟩ usually the country. Covers 190+ jurisdictions; where no Guideskill exists yet it returns a research_brief naming the official sources.

UpcomingTax taxfiling deadlines for a jurisdiction

Upcoming filing/payment deadlinesFiling and recurring filing rhythms (monthly VAT, quarterlypayment instalments)deadlines for a country or US state,: from'when theis OpenAccountantsmy tax calendar.return Usedue', it'when wheneverdo theI userfile asksVAT', 'when is Xthe due',next mentionsinstalment'. aReturns filingupcoming date,dates orand whenrecurring afiling heads-uprhythms about(monthly anVAT, imminentquarterly deadlineinstalments) wouldfrom help.the OpenAccountants tax calendar. Signed-in users with a saved home jurisdiction can omit `jurisdiction` — it fills from their profile`jurisdiction`; (the response marks jurisdiction_source accordingly).`jurisdiction_source`.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"UpcomingTax taxfiling deadlines for a jurisdiction"}

GetRead a tax skillGuide

FetchOpen a published skillGuide by slug (from start, includingsearch_skills itsor current-versionsearch_rules) markdownto answer the user's question. Returns the Guide's rules and method, its quality tier, the named verifieraccountant (where accountant-verified)one reviewed it, a `section_index` of sections not inlined, and a provenance/attributionprovenance footer.footer to keep with the answer.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetRead a tax skillGuide"}

Get aRead skill'smore sections of a Guide

Fetch the parsed sections of a skill's current version. Each section has a heading and its markdown content. Use thisFollow-up to pull a specificget_skill: sectionfetch thatsections get_skillit listed in `section_index` as not inlined (e.g.for example a supplier-pattern library) —. passPass `section_index` to fetchfor justone thatsection, one.or Omitomit it to get every section.section with its heading and markdown.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"Get aRead skill'smore sections of a Guide"}

Answers 'which countries do you cover?' or 'what is there for [country]?'. Returns every jurisdiction with published skills —Guides (countries (as ISO 2), US states (as US-XX), Canadian provinces —) with skillGuide counts, accountant-verifiedaccountant-reviewed counts, and named lead verifier. Use when the user asks 'which countries does OpenAccountants cover?' or 'what's available for [country]?' Avoidsnamed paginatinglead throughaccountant list_skillswhere tothere computeis this.one.

ReturnsHelper for search_rules: lists the metadatavalues you can filter on with `search_rules` — the (live jurisdictions, the domains, roles, block types (rule kinds), statuses, tax years, and a sample of topics —) plusand the defaults. CallTakes thisno beforearguments. `search_rules`Use toit learnwhen theunsure validof a filter valuesvalue rather than guessing.

ListBrowse tax & accounting skillsGuides

ListBrowse publishedthe OpenAccountantsGuides skillsfor withone theirjurisdiction qualityor tierdomain and(for verificationexample status.every OptionallyGuide filterfor by'MT', jurisdictionor (e.g.every 'US','payroll' 'MT'Guide), 'DE',each 'GB'),with domainits (thequality accountingtier area,and e.g.verification 'vat-gst',status. 'payroll'For a specific topic, 'income-tax')search_skills is quicker. Filter by jurisdiction, domain or role ('foundation' | 'compute' | 'orchestrator' | 'reference'). Results are paginatedPaginated (default 100, max 200 per call) — unfiltered browsing of the full ~1,100-skill catalogue requires paging via offset/next_offset, so jurisdiction/domain filters; arepage stronglywith recommended.offset/next_offset.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"ListBrowse tax & accounting skillsGuides"}

Returns named licensed accountants who have signed off on OpenAccountants jurisdictions, with their credentials and covered jurisdictions. Use when the user asks whoAnswers verified'who areviewed Guidethis?' or wants to see the'which accountants behindare thebehind library.this?'. IfReturns the user wants their own work checkednamed orlicensed done,accountants thatwho ishave asigned requestoff toon OpenAccountants through `share_with_openaccountants`jurisdictions, with `request_review:their true`,credentials atand the user'sjurisdictions requestthey only.cover.

SearchLook rulesup acrosstax jurisdictionsrates and rules

Sweep tax rulesLook ACROSSup jurisdictionstax andrates, metadatathresholds and get back a bundled markdown rule set plus the jurisdiction'srules OFFICIALin SOURCE.one Bestor formany cross-cuttingjurisdictions, questionssuch —as 'VAT rates in MT, IE and DE', 'all'income income-taxtax thresholdsbrackets for 2025', or 'rules mentioning reverse charge'. WHENReturns YOUa WANTbundled ONEmarkdown SPECIFICrule FIGUREset forplus oneeach jurisdictionjurisdiction's (aofficial singlesource rate,(`official_source`). thresholdFor orone date),specific preferfigure `search_skills`in thenone `get_skill`:jurisdiction thea Guide is where a topicoften ismore coveredcomplete in(search_skills full,then andget_skill): a figure can existsit in thea Guide without existing asbeing a separate rule here, in whichand casethen this tool will returnreturns related guidance rather than the number you asked for.instead. Entries whose text is guidance rather than a value are tagged `GUIDANCE` — never read one as a figure. IMPORTANT: this returns human-reviewed GUIDANCE andare doestext, NOTnot certifyvalues. thatFigures aare figurenot iscertified current —: confirm each number against the official source returned in `official_source` before you state it, and prefer that sourceit when they disagree. By default returns ALLall matching rules, each tagged with its verification status; pass status:'verified' forexcludes accountant-/research-verifieddraft, only.needs_update Calland `list_rule_facets`unsure firstrules; toit seestill includes research-verified (source-cited) rules, so it does not mean accountant-reviewed. list_rule_facets gives the queryablevalid filter values.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"SearchLook rulesup acrosstax jurisdictionsrates and rules"}

Search skillstax Guides by keywordtopic

Full-text search across all published tax and accountingFind skills.the Find,Guide lookup,for query,a orspecific discovertax skillstopic by keyword, tax: concept,a deduction type, form number, regime or regulationrule (e.g.such as 'home office deduction', 'crypto capital'Schedule gains'C', 'reverse charge', 'Schedule'crypto C',capital '60-daygains' reporting').or 'Beckham regime'. Optionally limit to one jurisdiction.jurisdiction Useor thisdomain. whenReturns youmatching don'tGuide knowslugs theto exactopen skillwith slug.get_skill. Set content_type='method' to discoverfind step-by-step METHODSmethods (guided procedures — what yourun EXECUTEthem via start()) instead of reference material;, each method carries a review_statustagged (accountant-reviewed |or source-cited).source-cited.

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"Search skillstax Guides by keywordtopic"}

SendsOnly feedbackwhen orthe auser reviewasks: requestsends totheir OpenAccountants.feedback, Thisor istheir therequest singlefor outbounda channel;person itto doescheck nothingor unlessdo the user has askedwork, forto it.OpenAccountants. Two modes. (1) `note`: an anonymized  ⟨164 unchanged words⟩ 

StartAnswer a tax workflowquestion (call first)

FrontCall doorthis first for any tax, /VAT/GST, accountingpayroll or filing question onceabout youa knowcountry whator theUS userstate, wants.such `intent`as is"how REQUIREDmuch (e.g.tax 'taxes',will 'VATI return'pay in Spain", 'set"do upI aneed company'to register for VAT", 'find"when deductions'is my tax return due", 'classify"is transactions'this deductible", 'payroll');"how passis a jurisdictionfreelancer tooor (ISOa 2-lettercompany taxed in Germany", e.g."sales 'MT'tax in Texas" or "what changes if I move to Portugal". Pass the user's question as `intent` and the country or US state as `jurisdiction` ('DE', 'GB''US-TX', 'US-CA''Florida'). If youno don'tplace yetis havenamed, anstart intent,infers callone `start_help`when first.the question makes it clear and says so in `jurisdiction_source`. Returns eitherthe aGuides clarificationto requestread next (if`skills_to_load`, jurisdictionopen iseach missingwith get_skill), or a ready-to-executewhat planis withstill theneeded, listusually ofthe skillscountry. toCovers load.190+ Calljurisdictions; thiswhere FIRSTno (afterGuide start_helpexists ifyet needed)it wheneverreturns thea userresearch_brief asksnaming forthe taxofficial help.sources.

{"properties":{"acting_as":{"description":"REQUIRED.Optional. Who the user is: 'self' = a taxpayer handling their OWNown taxes; 'client' = a professional (accountant/advisor) working on behalf of a CLIENT. Establish this before callingclient's —behalf. ifInfer it isn't clear from the conversation, ask the user one short question ('Are these your own taxes, or are you helpingconversation; aomit client?').it Neverif guess.unclear.","enum":["self","client"],"type":"string"},"intent":{"description":"UserRequired. intent

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"StartAnswer a tax workflowquestion (call first)"}

GetWhat tax-workflowcan scopingyou guidancehelp with? (no args)

No-argumentCall frontwhen doorthe —user callhas thisno FIRSTtax wheneverquestion ayet userand asksopens 'howwith 'what can you help me?'do?', 'what'how can you do?',help me?' or 'where do I start?', orstart?'. otherwiseTakes opensno vaguelyarguments. (doReturns NOTthe answertwo suchscoping questions by listingplus yourthe toolsavailable orintents callingand list_jurisdictions).jurisdictions; Forfor a signed-in approved accountant it returns, a personalizedshort personal `orientation` briefing (their standing + what their jurisdiction needs + one next action). For everyone else it returns the two scoping questions plus the available intents and jurisdictions.instead. Once youthere haveis ana intentquestion, call `start(intent, jurisdiction)`.`start`.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetWhat tax-workflowcan scopingyou guidancehelp with? (no args)"}

Validate aan businessEU VAT / tax-ID number (live registryVIES lookup)

Check live whether aan business'sEU VAT / tax-registration number is realvalid and registered, in real time against the official government registry — and return the registered business NAME and ADDRESS when thefor authorityexample disclosesbefore them.applying Thisa isB2B anreverse authoritativecharge, unfakeable confirmation you cannot get fromzero-rating aan knowledgeintra-EU lookupsale or from training data. Use it whenever a user wants to verifyonboarding a supplier's orsupplier. customer'sQueries taxthe ID:European beforeCommission's applyingVIES aregistry B2Band reversereturns charge,the zero-ratingverdict aplus cross-borderthe sale,registered orbusiness onboardingname aand vendor.address COVERAGEwhere TODAYthe ISauthority EUdiscloses ONLYthem. —Coverage: the 27 EU member states plus 'XI' (Northern Ireland), live via the European Commission's VIES registry; (use 'EL' for Greece).Greece. Other jurisdictions (e.g.countries, UK/HMRCincluding andthe beyond)UK, are NOTnot supported yet but are on the roadmap — for a non-EU number, tell the: usersay live validation isn't available foris thatnot countryavailable yetthere rather than guessing a verdict. This is a LIVE external lookup —guessing. ifIf the registry is temporarilydown unavailablethe itresponse says so plainly rather than inventing an answer.so.

 ⟨13 unchanged words⟩ channel; it does nothing unless the user has explicitly asked to send feedback or to request afor review.it. Two modes:modes. (1) `note` —: an anonymized note about the guidance (a  ⟨5 unchanged words⟩ or via `skill_slug` a bug in a specific skillGuide). Anonymize hard: no names, amounts, or PII. (2) `request_review: true`: —the submitsuser wants a person at OpenAccountants to check or do the user'swork. workingTypical paperrequests: 'can an accountant check this?', 'can someone file this for reviewme?', by'can someone do this for me?', 'I want an accountant', 'can I talk to a licensedperson?'. accountant;A alsoquestion about whether your own answer is right is not such a request; re-check it yourself. Also requires `working_paper` (complete), `jurisdiction`, `scenario`, and `contact_email`. The reviewrequest is a paidsaved professionalwith engagementOpenAccountants (neverand describethe itteam asis free);notified; the requestresponse returns an OpenAccountants booking link. The call is savedfree. toThe thework user'sitself ownis queuepaid: OpenAccountants does it through its accountants, with what is done and the response returnsfee aagreed bookingon linkthe —call nothingbefore reachesanything anstarts. accountantNever untildescribe the userwork engages.itself as free. Call at most once per explicit user request; never callnot as a routine closing step, and never solicit the request.step.

 ⟨3 unchanged words⟩ Review only, REQUIRED when request_review: the user's email.email, so OpenAccountants can reply. Ask for it first.","type":"string" ⟨62 unchanged words⟩ only when the user has asked for a licensedperson (an accountant or OpenAccountants) to reviewcheck their figures.result, file it or do the work. Requires working_paper + jurisdiction + scenario + contact_email.  ⟨24 unchanged words⟩ when the note is feedback about a SPECIFIC skillGuide, by its slug (e.g. 'us-sales-tax'). Replaces the old submit_feedback." ⟨36 unchanged words⟩ 

 ⟨11 unchanged words⟩ :"string"},"confirm_available":{"description":"WhetherAlways true: if the user can askasks, athe namedVAT accountanttreatment tocan confirmbe thesent VATfor treatmentchecking via ask_accountant_to_confirm.share_with_openaccountants with request_review.","type":"boolean"},"country_code":{ ⟨88 unchanged words⟩