# BoomTax - 1099, W-2, ACA Filing

BoomTax API - IRS Information Return Filing

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add boomtax/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list boomtax/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get boomtax/mcp-server get_filing_summary

# Call a tool
npx -y @smithery/cli@latest tool call boomtax/mcp-server get_filing_summary '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--boomtax.run.tools`

## Tools (10)

- `get_filing_summary` — Get aggregate filing counts grouped by status and form type for a tax year.
- `list_filing_types` — List all filing types supported by BoomTax with their tax year and e-file availability.
- `list_filing_forms` — List all forms belonging to a specific filing with their status and metadata.
- `get_form` — Get a specific form's metadata including type, status, and dates. TINs are always masked.
- `get_filing_details` — Get detailed information about a specific filing including payer summary and latest e-file status.
- `list_payers` — List payers (issuers) across your filings. TINs are not shown in the list view for security.
- `get_efile_errors` — Get e-file errors for a filing including header-level and per-form errors with error codes and messages.
- `list_filings` — List tax filings with optional filters. Returns paginated results with filing name, status, form type, and dates.
- `get_efile_status` — Get the e-file status for a filing including the full request/response timeline.
- `get_payer` — Get payer (issuer) details for a specific filing including masked TIN and contact information.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get boomtax/mcp-server <tool-name>
```
