Aiwyn Tax MCP Server

Official

A full federal and state 1040 calculation pipeline exposed as MCP tools.

Remote serverstreamable-http

What is the Aiwyn Tax MCP server?

Connect Aiwyn Tax to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Aiwyn's tax engine as an MCP server: discover schemas, validate inputs, calculate federal and state returns, and generate an IRS-formatted PDF. The aiwyn tax mcp server is what makes that connection.

What the server does

Aiwyn's tax engine as an MCP server: discover schemas, validate inputs, calculate federal and state returns, and generate an IRS-formatted PDF.

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • 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

Credentials and setup notes

An Aiwyn/Column Tax account for the OAuth flow, an MCP client supporting remote Streamable HTTP, and source tax documents for the year being calculated.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Aiwyn Tax.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Among the payments and commerce options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Aiwyn Tax's toolset — tax_years, tax_jurisdictions, tax_namespaces and 7 more — is a fair guide to whether it matches your workflow. It is maintained by Aiwyn, Inc. rather than a third party, which usually means auth handling and breaking changes are dealt with faster.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

What you can do with it

Conversational return preparation

A user shares W-2s in chat; the assistant extracts the figures, populates the schemas, validates, calculates and returns a filled 1040 PDF.

Scenario modelling

Recalculate a return with different filing statuses, dependents or credits to see how the outcome shifts before committing to an approach.

Embedding tax math in a product

Use the MCP tools as the calculation backend for an assistant-driven filing UI instead of building and maintaining a tax engine in-house.

Validation harness

Run check_tax across a batch of constructed inputs to catch schema and eligibility problems early in a data pipeline.

Available tools

ToolWhat it does
tax_yearsList every tax year the calculation engine currently supports.
tax_jurisdictionsList supported jurisdictions for a given tax year.
tax_namespacesList the input namespaces available for a jurisdiction and tax year.
tax_namespace_schemaReturn the JSON schema for a single namespace such as irs1040, w2 or a state form, in summary or full detail.
tax_simple_returnBootstrap a scenario: returns a curated namespace list, top-level input structure, example payload and a workflow guide.
check_taxValidate an input object before calculation and surface validation errors and partial disqualifications.
calculate_taxRun the full return calculation and return a markdown summary of all computed fields.
generate_tax_pdf_toolStart asynchronous generation of an IRS or state-formatted PDF return and return a job ID.
get_tax_pdf_toolPoll a PDF generation job for its status and download URL.
generate_uuid_v5Generate a deterministic UUIDv5 from a source UUID and namespace name, used to link state entries to their federal counterparts.

How to install the Aiwyn Tax MCP server

claude mcp add aiwyn-tax --transport http https://mcp.columnapi.com/mcp

Configuration

An Aiwyn/Column Tax account for the OAuth flow, an MCP client supporting remote Streamable HTTP, and source tax documents for the year being calculated.

Example prompts to try

  • I'm single with W-2 income only, filing federal plus Arizona for TY25 — set up the input structure and walk me through it.
  • Using the documents in this folder, prepare my tax return and show the calculated breakdown.
  • Validate this input object and tell me exactly which fields are failing and why.
  • Calculate my 2025 return, then generate the PDF and give me the download link when it's ready.

Frequently asked questions

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.