schwarztim/freetaxusa-mcp

Browser automation

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

10 stars 5 forks Качество 79 Тренд 26MIT

Repository Install

MCP-сервер для подачи налогов через FreeTaxUSA с помощью автоматизации браузера Playwright

Обзор

Сервер MCP, который позволяет агентам ИИ подавать ваши налоги через FreeTaxUSA - бесплатную федеральную службу подачи налоговых деклараций. Вместо того, чтобы платить 120 долларов за собеседование с TurboTax, этот MCP дает любому помощнику AI (Клоду и т. Д.) возможность перемещаться по интерфейсу FreeTaxUSA, заполнять формы, проверять возврат средств и проводить вас через подачу заявки. Это не обертка API. FreeTaxUSA не имеет публичного API. Этот MCP использует Playwright для управления реальной сессией браузера Chromium против веб-интерфейса FreeTaxUSA. Он считывает формы через дерево доступности, заполняет поля, перемещается между разделами и возвращает структурированные данные агенту ИИ, который затем говорит с вами, как человек, подготавливающий налоги.

Обзор (машинный перевод)

Сервер MCP, который позволяет агентам ИИ подавать ваши налоги через FreeTaxUSA - бесплатную федеральную службу подачи налоговых деклараций.

Вместо того, чтобы платить 120 долларов за собеседование с TurboTax, этот MCP дает любому помощнику AI (Клоду и т. Д.) возможность перемещаться по интерфейсу FreeTaxUSA, заполнять формы, проверять возврат средств и проводить вас через подачу заявки.

Федеральная регистрация бесплатна. Штат составляет $15,99. Вот и все.

Как это работает

Это не обертка API. FreeTaxUSA не имеет публичного API.

Этот MCP использует Playwright для управления реальной сессией браузера Chromium против веб-интерфейса FreeTaxUSA. Он считывает формы через дерево доступности, заполняет поля, перемещается между разделами и возвращает структурированные данные агенту ИИ, который затем говорит с вами, как человек, подготавливающий налоги.

Особенности

15 инструментов подачи налоговых деклараций в отношении личной информации, доходов, вычетов, проверки и подачи Session persistence — вход один раз, файлы cookie выживают между вызовами ** Защита PII** - SSN, номера счетов и EIN автоматически отредактированы со всех выходов инструментов ** Динамическая навигация** - обнаруживает структуру раздела FreeTaxUSA во время выполнения

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

Открыть полный README на GitHub

Установка

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"]
    }
  }
}