schwarztim/freetaxusa-mcp

Browser automation

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

10 stars 5 forks 품질 79 트렌드 26MIT

Repository Install

MCP 서버는 Playwright 브라우저 자동화를 사용하여 FreeTaxUSA를 통해 AI 보조 세금 징수

개요

AI 에이전트가 FreeTaxUSA를 통해 세금을 파일 할 수있는 MCP 서버 -- 무료 연방 세금 징수 서비스. TurboTax의 가이드 인터뷰에 대해 $ 120 +를 지불하는 대신이 MCP는 FreeTaxUSA의 인터페이스를 탐색 할 수있는 AI 조수 (Claude 등)를 제공합니다, 양식을 작성하고 환불을 확인하고 대화를 통해 걸어. 이것은 API 래퍼가 아닙니다. FreeTaxUSA는 공개 API가 없습니다. 이 MCP는 FreeTaxUSA의 웹 인터페이스에 대한 실제 크롬 브라우저 세션을 구동하기 위해 Playwright를 사용합니다. Accessibility tree를 통해 양식을 읽습니다. 필드를 채우고 섹션을 탐색하고 구조화 된 데이터를 AI 에이전트로 반환합니다. 그런 다음 인간 세금 준비자처럼 이야기합니다.

개요(AI 번역)

AI 에이전트가 FreeTaxUSA를 통해 세금을 파일 할 수있는 MCP 서버 – 무료 연방 세금 징수 서비스.

TurboTax의 가이드 인터뷰에 대해 $ 120 +를 지불하는 대신이 MCP는 FreeTaxUSA의 인터페이스를 탐색 할 수있는 AI 조수 (Claude 등)를 제공합니다, 양식을 작성하고 환불을 확인하고 대화를 통해 걸어.

** 개인 서류는 무료입니다. 국가는 $ 15.99입니다. 그게 다.**

그것이 작동하는 방법

이것은 API 래퍼가 아닙니다. FreeTaxUSA는 공개 API가 없습니다.

이 MCP는 FreeTaxUSA의 웹 인터페이스에 대한 실제 크롬 브라우저 세션을 구동하기 위해 Playwright를 사용합니다. Accessibility tree를 통해 양식을 읽습니다. 필드를 채우고 섹션을 탐색하고 구조화 된 데이터를 AI 에이전트로 반환합니다. 그런 다음 인간 세금 준비자처럼 이야기합니다.

특징

**15 세금 징수 도구 ** 개인 정보, 소득, 공제, 검토 및 제출
**Session persistence ** – 로그인 한 번, 쿠키는 invocation 사이에 살아남
PII 보호 – SSNs, 계정 번호 및 EINs는 모든 공구 산출에서 자동적으로 적습니다 -Dynamic navigation – runtime의 FreeTaxUSA의 섹션 구조 발견

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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.

GitHub에서 전체 README 보기

설치

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