schwarztim/freetaxusa-mcp
Browser automationこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCP server for AI-assisted tax filing through FreeTaxUSA using Playwright browser automation
概要
An MCP server that lets AI agents file your taxes through FreeTaxUSA -- the free federal tax filing service. Instead of paying $120+ for TurboTax's guided interview, this MCP gives any AI assistant (Claude, etc.) the ability to navigate FreeTaxUSA's interface, fill forms, check your refund, and walk you through filing -- conversationally. This is not an API wrapper. FreeTaxUSA has no public API. This MCP uses Playwright to drive a real Chromium browser session against FreeTaxUSA's web interface. It reads forms via the accessibility tree, fills fields, navigates between sections, and returns structured data to the AI agent -- which then talks to you like a human tax preparer would.
README
以下は原文 README の抜粋です。原文を見る。
FreeTaxUSA MCP Server
An MCP server that lets AI agents file your taxes through FreeTaxUSA – the free federal tax filing service.
Instead of paying $120+ for TurboTax’s guided interview, this MCP gives any AI assistant (Claude, etc.) the ability to navigate FreeTaxUSA’s interface, fill forms, check your refund, and walk you through filing – conversationally.
Federal filing is free. State is $15.99. That’s it.
How It Works
This is not an API wrapper. FreeTaxUSA has no public API.
This MCP uses Playwright to drive a real Chromium browser session against FreeTaxUSA’s web interface. It reads forms via the accessibility tree, fills fields, navigates between sections, and returns structured data to the AI agent – which then talks to you like a human tax preparer would.
You: "Here's my W-2, help me file"
|
[Claude / AI Agent]
|
[FreeTaxUSA MCP] <-- this project
|
[Playwright + Chromium]
|
[freetaxusa.com]
|
[IRS e-file]
Features
- 15 tax filing tools across personal info, income, deductions, review, and filing
- Session persistence – login once, cookies survive between invocations
- PII protection – SSNs, account numbers, and EINs are automatically redacted from all tool outputs
- Dynamic navigation – discovers FreeTaxUSA’s section structure at runtime
- Anti-bot mitigations – realistic viewport, disabled automation flags
- State paywall detection – warns before triggering the $15.99 state filing purchase
- Prior year support – configurable tax year for filing back taxes
Tools
Session Management
| Tool | Description |
|---|---|
authenticate |
Log in. With Hermes configured, the session is brokered (no credentials needed). Otherwise pass email/password — used once, never stored. |
get_session_status |
Check if session is active, which tax year and section is loaded. |
Page Interaction
| Tool | Description |
|---|---|
read_current_page |
Read all form fields and their current values on the active page. |
save_and_continue |
Submit the current page and advance to the next. |
navigate_section |
Jump to a section by name (“income”, “deductions”) or SID number. |
Personal Information
| Tool | Description |
|---|---|
fill_taxpayer_info |
Fill name, SSN, DOB, occupation, and address. |
fill_filing_status |
Set filing status (single, married joint, head of household, etc.). |
Tax Overview
| Tool | Description |
|---|---|
get_tax_summary |
Get return overview: refund/owed, AGI, filing status, completed sections. |
get_refund_estimate |
Get current federal and state refund or amount owed. |
Income (Phase 2)
| Tool | Description |
|---|---|
fill_w2_income |
Enter W-2 wage and withholding data. |
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"freetaxusa": {
"type": "stdio",
"command": "node",
"args": ["/path/to/freetaxusa-mcp/dist/index.js"]
}
}
}