# Aiwyn MCP MCP Server

> **Aiwyn MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Aiwyn MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/aiwyn-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Estimate your federal & state taxes using Aiwyn's tax engine that's filed over 1 million returns. Give Claude your tax documents (e.g. W-2s) and get a 1040 PDF back.

---

## Details

- Server ID: `aiwyn-mcp`
- Version: 1.0.0
- Tools: 10
- Authentication: None — this server takes no credential
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Aiwyn MCP has to be in the toolset
first. In order:

1. Add Aiwyn MCP to your toolset at https://mewcp.com/mcp/aiwyn-mcp
2. Nothing to connect — Aiwyn MCP needs no credential
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (10)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `check_tax` _(read)_ — 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…
- `calculate_tax` _(read)_ — 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…
- `tax_years` _(read)_ — List all supported tax years.
- `tax_jurisdictions` _(read)_ — List all supported tax jurisdictions for a given tax year.
- `tax_namespace_schema` _(read)_ — 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…
- `tax_namespaces` _(read)_ — 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…
- `tax_simple_return` _(read)_ — 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.…
- `generate_tax_pdf_tool` _(write)_ — 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…
- `get_tax_pdf_tool` _(read)_ — 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_uuid_v5` _(read)_ — Generate a UUID v5 based on a source uuid and namespace.

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/aiwyn-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/aiwyn-mcp/connect/chatgpt
- VS Code: https://mewcp.com/mcp/aiwyn-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/aiwyn-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/aiwyn-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/aiwyn-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/aiwyn-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/aiwyn-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/aiwyn-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/aiwyn-mcp/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/aiwyn-mcp/connect/dsh
- Python: https://mewcp.com/mcp/aiwyn-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/aiwyn-mcp/connect/typescript