Aiwyn Tax — MCP server for Claude Code: automate tax returns
Aiwyn Tax — an MCP server for tax return automation and client engagement management across US federal and state jurisdictions. Validates tax data, calculates returns, and generates PDF reports directly from your editor.
no license 6,395 installs updated 2026-03-27
claude mcp add --transport http aiwyn https://aiwyn.run.toolsWhat Aiwyn Tax does
Aiwyn Tax connects to Claude Code, Cursor, GitHub Copilot and other editors via MCP to handle tax calculation workflows. The server supports multiple US tax jurisdictions and years, with tools to list available schemas, validate inputs before calculation, and generate PDF documents. Use check_tax to validate input data against a namespace schema, calculate_tax to compute the return, and generate_tax_pdf_tool followed by get_tax_pdf_tool to create and retrieve PDF output.
Input data must conform to the JSON schema returned by tax_namespace_schema for a specific namespace like irs1040 or ca_form540. Start with tax_simple_return to get the structure for a basic scenario (W-2 income, standard deduction, no dependents). Discover jurisdictions with tax_jurisdictions and available namespaces for a jurisdiction with tax_namespaces.
The server runs at https://aiwyn.run.tools and works with Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed, and Gemini CLI. Your editor must support MCP and HTTP-based connections to use it.
What it helps with
- Calculate US tax returns across federal and state forms
- Validate taxpayer data before generating a return
- Generate and download PDF tax forms for clients
- List supported tax years and filing jurisdictions
- Embed tax calculations into your editor's workflow
Example prompts for the agent
- Show me available jurisdictions for this tax year, then calculate a simple 1040 federal return.
- Validate my W-2 income data against the
irs1040schema before I generate the full return. - Generate a PDF tax return and give me the download link when it's ready.
How to install Aiwyn Tax
Platform CLI: remote server
claude mcp add --transport http aiwyn https://aiwyn.run.toolsPlatform CLI: remote server
codex mcp add aiwyn-tax --url https://aiwyn.run.toolsConfig file
{
"mcpServers": {
"aiwyn-tax": {
"url": "https://aiwyn.run.tools"
}
}
}Config file
{
"servers": {
"aiwyn-tax": {
"type": "http",
"url": "https://aiwyn.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http aiwyn-tax https://aiwyn.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Aiwyn Tax
How do I install Aiwyn Tax in Claude Code?
Run claude mcp add --transport http aiwyn https://aiwyn.run.tools or claude mcp add --transport http aiwyn-tax https://aiwyn.run.tools to add the server. The second command uses an explicit server name.
What does Aiwyn Tax do?
It automates tax return calculations for US federal and state forms, validates input against filing schemas, checks for disqualifications, and generates PDF returns within your code editor.
Which tax forms and jurisdictions are supported?
The server covers multiple US tax years and jurisdictions. Use tax_years to list available years, tax_jurisdictions for a given year, and tax_namespaces to see forms for a specific jurisdiction like federal or state returns.