# Aiwyn Tax

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 6395 installs
- Author: aiwyn
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/aiwyn
- Updated: 2026-03-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/aiwyn-tax

## What it 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.

## Requirements
- Remote server: `https://aiwyn.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http aiwyn https://aiwyn.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add aiwyn-tax --url https://aiwyn.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aiwyn-tax": {
            "url": "https://aiwyn.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aiwyn-tax": {
            "type": "http",
            "url": "https://aiwyn.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http aiwyn-tax https://aiwyn.run.tools
```

## When to use it
- 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
- Show me available jurisdictions for this tax year, then calculate a simple 1040 federal return.
- Validate my W-2 income data against the `irs1040` schema before I generate the full return.
- Generate a PDF tax return and give me the download link when it's ready.

## Similar
- [tax-penalty-calc](https://affpapa.org/en/nevibecode/skills/tax-penalty-calc.md) — skill · 433 installs
- [tax-prep](https://affpapa.org/en/nevibecode/skills/tax-prep.md) — skill · 2000 installs
- [tax-season-organizer](https://affpapa.org/en/nevibecode/skills/tax-season-organizer.md) — skill · 1800 installs
- [state-tax-estimator](https://affpapa.org/en/nevibecode/skills/state-tax-estimator.md) — skill · 436 installs
- [invoice-tax-checklist](https://affpapa.org/en/nevibecode/skills/invoice-tax-checklist.md) — skill · ★ 12746 repo stars
- [tax-calendar-proactive](https://affpapa.org/en/nevibecode/skills/tax-calendar-proactive.md) — skill · ★ 38 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
