> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Aiwyn Tax MCP

> Aiwyn Tax (formerly Column Tax) estimates federal and state taxes with Aiwyn's tax engine.

![Aiwyn Tax MCP logo](https://mintcdn.com/composio-preview/qzegrvAapILigeDI/images/toolkits/aiwyn_tax_mcp.svg?fit=max\&auto=format\&n=qzegrvAapILigeDI\&q=85\&s=1fcc362b80a90591dbcf54acf554a5a2)

* **Category:** taxes
* **Auth:** NO\_AUTH
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `AIWYN_TAX_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Calculate tax
>
> **Slug:** `AIWYN_TAX_MCP_CALCULATE_TAX`
>
> Calculate a tax return for a given jurisdiction. The 'input' argument must conform to the JSON schema returned by the tax\_namespace\_schema tool. Returns computed tax return document on success, or validation errors if the input is invalid. If some inputs trigger a PARTIAL DISQUALIFICATION, the document is still returned for the supported fields; review the disqualification details and estimate the impact of the unsupported fields on the taxpayer's tax owed or refund due. Use the check\_tax tool first to validate the input before calculating the tax return with this tool.IMPORTANT RULES: (1) All field values must be wrapped as \{"value": \<val>} — never pass bare values. (2) Currency amounts are whole-dollar integers (e.g. \$19,312.42 = 19312). (3) Every item in an array namespace (NamespaceList) must have a "uuid" field with a valid UUIDv4 string. UUIDv4 format: xxxxxxxx-xxxx-4xxx-\[89ab]xxx-xxxxxxxxxxxx — the 3rd group MUST start with '4' (version) and the 4th group MUST start with '8', '9', 'a', or 'b' (variant). NEVER construct UUIDs manually (e.g. 'B1111111-1111-1111-1111-111111111111' is invalid). Use a UUID generator; example valid value: 'a3b4c5d6-e7f8-4a9b-8c0d-1e2f3a4b5c6d'. (4) Nested arrays (e.g. w2\_state\_local\_tax\_grp inside a w2) also require a UUIDv4 on each item. (5) Use "who\_applies\_to" to cross-reference entries: \{"value": "taxpayer"} for singletons, \{"value": "\<namespace>#\<uuid>"} for array items (e.g. "dependent\_detail#\<uuid>"). Other named reference fields (e.g. "person" in qualifying\_person\_grp, "student" in student\_educational\_instn\_grp) use the same "\<namespace>#\<uuid>" format. (6) For state returns with Extended Links (state namespace extending a federal NamespaceList), each extended link item must use a UUIDv5 generated from the source item's UUID (as the namespace) and the extended namespace name (as the name). Matching is UUID-based, not positional. The number of expected instances depends on the source formula — it is NOT always a 1:1 match with the federal list. Incorrect or random UUIDs cause SILENT DATA LOSS — the server drops unrecognized UUIDs and replaces them with empty instances. Use the generate\_uuid\_v5 tool with the source item's UUID as the source\_uuid and the extended namespace name as the namespace input. Example: generate\_uuid\_v5(source\_uuid: \<source item uuid>, namespace: "ca\_irsw2\_g") links a federal Form W-2G item to its California extension. NOTE: ordinary Form W-2 data does NOT use an extended link — state returns derive it automatically from the federal w2 namespace, so do not generate a UUIDv5 for it. Call tax\_namespaces for the jurisdiction to see which extended namespaces it actually exposes. (7) return\_header is top-level, NOT nested inside return\_data. Use tax\_simple\_return first to see the full input structure and examples. When returning the tax calculation inform the user that I'm just a tax estimator, you should consult with a tax professional.
>
> #### Input Parameters
>
> **input** `object` *required*
>
> Tax input data conforming to the schema from the tax\_namespace\_schema tool.
>
> **tax\_year** `string`
>
> Tax year to calculate for (e.g., "TY25"). Defaults to the current tax year.
>
> **jurisdiction** `string`
>
> State jurisdiction to calculate (e.g., "pa"), in addition to federal.Use the tax\_jurisdictions tool to list available jurisdictions.

> [accordion] Check tax
>
> **Slug:** `AIWYN_TAX_MCP_CHECK_TAX`
>
> Check inputs to calculate a tax return for a given jurisdiction. The 'input' argument must conform to the JSON schema returned by the tax\_namespace\_schema tool. Returns 'Success' on success, or validation errors if the input is invalid. If some inputs trigger a PARTIAL DISQUALIFICATION, the check still succeeds but includes disqualification details — proceed to calculate\_tax to get the document and estimate the impact. Use this tool to validate inputs before calculating the tax return.
>
> #### Input Parameters
>
> **input** `object` *required*
>
> Tax input data conforming to the schema from the tax\_namespace\_schema tool.
>
> **tax\_year** `string`
>
> Tax year to calculate for (e.g., "TY25"). Defaults to the current tax year.
>
> **jurisdiction** `string`
>
> State jurisdiction to validate (e.g., "pa"), in addition to federal.Use the tax\_jurisdictions tool to list available jurisdictions.

> [accordion] Generate tax pdf tool
>
> **Slug:** `AIWYN_TAX_MCP_GENERATE_TAX_PDF_TOOL`
>
> Start async PDF generation for a tax return. The 'input' argument must conform to the JSON schema returned by the tax\_namespace\_schema tool. Returns a job ID to poll with get\_tax\_pdf.Use the check\_tax tool first to validate the input before generating the tax PDF with this tool.The input follows the same rules as calculate\_tax: all values wrapped as \{"value": \<val>}, array items require UUIDv4 fields (extended link items use UUIDv5), references use who\_applies\_to, and return\_header is top-level (not inside return\_data). Use tax\_simple\_return to see the full input structure.
>
> #### Input Parameters
>
> **input** `object` *required*
>
> Tax input data conforming to the schema from the tax\_namespace\_schema tool.
>
> **tax\_year** `string`
>
> Tax year to generate for (e.g., "TY25"). Defaults to the current tax year.
>
> **jurisdiction** `string`
>
> Jurisdiction to include in the PDF (e.g., "pa"), in addition to the federal.Use the tax\_jurisdictions tool to list available jurisdictions.

> [accordion] Generate uuid v5
>
> **Slug:** `AIWYN_TAX_MCP_GENERATE_UUID_V5`
>
> Generate a UUID v5 based on a source uuid and namespace.
>
> #### Input Parameters
>
> **namespace** `string` *required*
>
> The namespace to use for generating the UUID v5.
>
> **source\_uuid** `string` *required*
>
> The source UUID to use for generating the UUID v5.

> [accordion] Get tax pdf tool
>
> **Slug:** `AIWYN_TAX_MCP_GET_TAX_PDF_TOOL`
>
> Check status of a PDF generation job. Returns the status and a download URL when completed, only     use this tool after generating the tax PDF with the generate\_tax\_pdf tool and it successfully returns a job ID.     When returning the url of the PDF inform the user that I'm just a tax estimator, you should consult with a tax     professional.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The PDF result UUID returned by generate\_tax\_pdf.

> [accordion] Tax jurisdictions
>
> **Slug:** `AIWYN_TAX_MCP_TAX_JURISDICTIONS`
>
> List all supported tax jurisdictions for a given tax year.
>
> #### Input Parameters
>
> **tax\_year** `string`
>
> Tax year to list jurisdictions for (e.g., "TY25"). Defaults to the current tax year.

> [accordion] Tax namespaces
>
> **Slug:** `AIWYN_TAX_MCP_TAX_NAMESPACES`
>
> List all available input namespaces for a given jurisdiction. Use the returned names with the tax\_namespace\_schema tool to get the schema for a specific namespace. Requires a jurisdiction (e.g. "us" for federal, "ca" for California). Use the tax\_jurisdictions tool first to discover available jurisdictions. NAMESPACE NAMING CONVENTIONS: Federal namespaces: irs1040, irs1040\_schedule1, irs8962, w2, dependent\_detail, etc. State namespaces: always prefixed with the state abbreviation (ca\_form540, ny\_it201, az\_form140). NAMESPACE TYPES: Some namespaces are singletons (object), others are NamespaceLists (array) that can hold multiple items — e.g. w2 (multiple W-2s), dependent\_detail (multiple dependents), irs1040\_schedulec (multiple businesses). NamespaceList items require UUIDv4 fields. State NamespaceLists may act as Extended Links that extend a federal NamespaceList (e.g. ca\_irsw2\_g extends the federal Form W-2G list). Extended link items must use UUIDv5 (deterministic, derived from source item UUID as namespace + extended namespace name as name). Matching is UUID-based, not positional. Wrong UUIDs cause silent data loss. Use the generate\_uuid\_v5 tool with the source item's UUID as the source\_uuid and the extended namespace name as the namespace input. Example: generate\_uuid\_v5(source\_uuid: \<source item uuid>, namespace: "ca\_irsw2\_g"). NOTE: ordinary Form W-2 data does NOT use an extended link — state returns derive it automatically from the federal w2 namespace. The list this tool returns for a jurisdiction is authoritative: only namespaces it names can be passed to tax\_namespace\_schema or included in an input payload.
>
> #### Input Parameters
>
> **tax\_year** `string`
>
> Tax year (e.g. "TY25"). Defaults to the current tax year.
>
> **jurisdiction** `string` *required*
>
> Jurisdiction to list namespaces for (e.g. "us", "ca", "az").

> [accordion] Tax namespace schema
>
> **Slug:** `AIWYN_TAX_MCP_TAX_NAMESPACE_SCHEMA`
>
> Get the TCB input schema for a single namespace (e.g. "irs1040", "irs1040\_schedulec", "ca\_form540"). Returns the properties and types for that namespace. HOW TO READ THE SCHEMA: (1) Each field references a type like tcb\_string\_null, tcb\_integer\_null, or tcb\_boolean\_null. All values must be wrapped as \{"value": \<val>}. (2) If the namespace title ends in '\_list' (e.g. 'w2\_list', 'dependent\_detail\_list'), it is a NamespaceList — an array of objects. Each array item MUST include a "uuid" field (non-null UUIDv4 string). (3) Reference fields link entries to other namespaces e.g. "person" in qualifying\_person\_grp, "student" in student\_educational\_instn\_grp. All use the same format: \{"value": "\<namespace>#\<uuid>"} (e.g. "dependent\_detail#\<uuid>"). (4) Nested arrays within a namespace (e.g. w2\_state\_local\_tax\_grp inside w2) also require uuid on each nested item. (5) Pattern-validated strings (e.g. SSNs, ZIPs, dates) have regex constraints in the schema \$defs. SSNs/EINs: 9-digit string (no dashes). ZIPs: 5 or 9 digits. Dates: YYYY-MM-DD.
>
> #### Input Parameters
>
> **format** `string ("summary" | "full")`
>
> Output format. "summary" (default) returns a compact list of fields with type, enum, required, and description. "full" returns the raw JSON Schema.
>
> **tax\_year** `string`
>
> Tax year (e.g. "TY25"). Defaults to the current tax year.
>
> **namespace** `string` *required*
>
> The namespace ID (e.g. "irs1040", "irs1040\_schedulec", "ca\_form540").

> [accordion] Tax simple return
>
> **Slug:** `AIWYN_TAX_MCP_TAX_SIMPLE_RETURN`
>
> Call this FIRST when beginning any tax return. Returns the curated namespace list, top-level structure guide, example input, and step-by-step filing workflow. By default returns a simple scenario (single or MFJ filer, W-2 income only, standard deduction, no dependents). Pass scenario="with\_dependents" for returns that include dependents, child care (Form 2441), and education credits (Form 8863). Optionally pass a state jurisdiction (e.g. "ca") to also include state-level namespaces — if you don't know which state applies, ask the user before calling.
>
> #### Input Parameters
>
> **scenario** `string ("simple" | "with_dependents")`
>
> Return scenario. "simple" (default): single/MFJ, W-2 only, no dependents. "with\_dependents": includes dependents, Form 2441 (child care), and Form 8863 (education credits).
>
> **tax\_year** `string`
>
> Tax year (e.g. "TY25"). Defaults to the current tax year.
>
> **jurisdiction** `string`
>
> State jurisdiction code (e.g. "ca", "ny"). Omit for federal-only.

> [accordion] Tax years
>
> **Slug:** `AIWYN_TAX_MCP_TAX_YEARS`
>
> List all supported tax years.
