Question 1

Which jurisdictions does the Aiwyn Tax MCP server support?

Accepted Answer

It calculates federal returns and covers 44 state jurisdictions, with federal and a single state bundled into one call. Query tax_jurisdictions for a given tax year to see the authoritative current list rather than assuming a state is included.

Question 2

Why do my calculations come back with missing data?

Accepted Answer

Almost always a UUID problem. Every item in an array namespace needs its own UUIDv4, nested arrays need them too, and state namespaces that extend a federal list must use a UUIDv5 produced by generate_uuid_v5. Matching is by UUID rather than position, and mismatches cause silent data loss instead of an error.

Question 3

Is the PDF returned immediately?

Accepted Answer

No — PDF generation is asynchronous. generate_tax_pdf_tool starts a job and returns an ID, then get_tax_pdf_tool is polled for status and a download URL. This is deliberate so the flow works for background jobs and UI integrations rather than blocking a conversation.

Question 4

Can I rely on the output to file my taxes?

Accepted Answer

Treat it as an estimate produced by a well-tested engine, not as tax advice. The numbers only reflect what the model extracted from your documents, so a single misread box becomes a wrong return without any warning. Review the computed figures against your source documents before filing anything.

Question 5

What order should the tools be called in?

Accepted Answer

Start with tax_simple_return to bootstrap the scenario, fetch each tax_namespace_schema you need (these can run in parallel), assemble the input following the wrapping and UUID rules, run check_tax to validate, then calculate_tax, and finally the two PDF tools.

Tool	What it does
tax_years	List every tax year the calculation engine currently supports.
tax_jurisdictions	List supported jurisdictions for a given tax year.
tax_namespaces	List the input namespaces available for a jurisdiction and tax year.
tax_namespace_schema	Return the JSON schema for a single namespace such as irs1040, w2 or a state form, in summary or full detail.
tax_simple_return	Bootstrap a scenario: returns a curated namespace list, top-level input structure, example payload and a workflow guide.
check_tax	Validate an input object before calculation and surface validation errors and partial disqualifications.
calculate_tax	Run the full return calculation and return a markdown summary of all computed fields.
generate_tax_pdf_tool	Start asynchronous generation of an IRS or state-formatted PDF return and return a job ID.
get_tax_pdf_tool	Poll a PDF generation job for its status and download URL.
generate_uuid_v5	Generate a deterministic UUIDv5 from a source UUID and namespace name, used to link state entries to their federal counterparts.

Aiwyn Tax MCP Server

What is the Aiwyn Tax MCP Server?

Credentials and setup notes

More MCP options

What you can do with it

Conversational return preparation

Scenario modelling

Embedding tax math in a product

Validation harness

Recorded tools

How to install the Aiwyn Tax MCP Server

Configuration

Example prompts to try

Frequently asked questions

Alternatives to the Aiwyn Tax MCP Server

Stripe

Git

PasteApply

Turkey Payments (iyzico — Turkish cards / taksit)

Agenttax MCP

Apify Market Intelligence