freetaxusa.com

{
  "name": "get_current_page",
  "kind": "answer",
  "impl": "imperative",
  "description": "Describe the FreeTaxUSA page the person is on: its title, link and canonical link, its main heading and section headings, the help articles it shows and, on an article page, that article's id (ids to read in full), the sign-in and start-return buttons on it, and the tools available right now. Call it after arriving on a page or after open_page.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "find_page",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search FreeTaxUSA's own pages by topic, for example \"1099-NEC\", \"Oregon\", \"extension\" or \"military\", and return up to 8 matching pages with their titles, descriptions, paths and links. Open one in this tab with open_page. Help articles are searched separately, with the help search tool.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "A topic, form, state or situation, for example \"self-employed\" or \"Form 1099-K\"."
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "open_page",
  "kind": "act",
  "impl": "imperative",
  "description": "Open another FreeTaxUSA page in this tab by its path, for example \"/pricing\" or \"/states/oregon\", and return a description of the new page, as get_current_page does. Use a path from find_page or from a link on this page. Only pages on this site open; sign-in and start-return buttons have their own tools.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "path": {
        "type": "string",
        "description": "A path on this site starting with \"/\", for example \"/pricing\" or \"/survey?name=feedback\"."
      }
    },
    "required": [
      "path"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_pricing",
  "kind": "answer",
  "impl": "imperative",
  "description": "Current FreeTaxUSA prices for the 2025 tax year, in US dollars, as the pricing page shows them. Federal returns are $0. The state return, Deluxe, Pro Support, Audit Defense, amended, printed, bound and prior-year prices are listed separately, plus the fee for paying out of a federal refund.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_key_dates",
  "kind": "answer",
  "impl": "imperative",
  "description": "The IRS dates on FreeTaxUSA's deadline page for the 2025 tax year: when the IRS starts processing returns, the April filing deadline, and the extension deadline, plus today's date and whether each deadline has passed. irsStartsProcessing is null until the IRS announces it. Dates are US local dates in YYYY-MM-DD form.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "search_faqs",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search FreeTaxUSA's tax help library and return up to 5 matching articles with their ids, titles and links. Use it for questions about tax forms, credits, deductions, filing situations, and how the software handles them. Titles are not answers: read the article with get_faq before giving tax guidance. An empty results list means no article matched.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "A plain-language tax question, for example \"Can I deduct student loan interest?\""
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_faq",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read up to 5 articles from FreeTaxUSA's tax help library in full, by id. Returns each article's title, its text with the formatting removed, and its link. Get ids from search_faqs or from get_current_page. An id that does not exist is left out of the results.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "minItems": 1,
        "maxItems": 5,
        "description": "Help article ids from a search result's id or from get_current_page, for example [1605]."
      }
    },
    "required": [
      "ids"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_entry_links",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns links, without opening them: startNewReturn for a new 2025 return, signInToContinue for a return already started, priorYearReturn to start a return for taxYear (default 2024), and accountRecovery for a lost username or password. Each opens the sign-in site, where the person signs in or creates an account themselves.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "taxYear": {
        "type": "integer",
        "description": "A prior tax year for priorYearReturn, 2018 to 2024. Defaults to 2024."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_state_info",
  "kind": "answer",
  "impl": "imperative",
  "description": "Whether FreeTaxUSA can prepare and e-file a state's 2025 return yet, as its state e-file availability page shows. For one state: whether it has a state return, its price (null when there is no return) and its page. With no state: compact lists of abbreviations by readiness, including the states with no return.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "state": {
        "type": "string",
        "description": "A US state name or two-letter abbreviation, for example \"California\" or \"CA\". Omit to list every state."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "search_forms",
  "kind": "answer",
  "impl": "imperative",
  "description": "Check whether FreeTaxUSA supports a federal or state tax form, using the same lookup as its forms page. Search by form number (\"1099-K\", \"Schedule E\", \"1040-NR\") or a state name. supported and primaryMatch are the verdict for the form searched; relatedMatches are other forms with similar names, often from other jurisdictions, and are not the verdict.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "A form number or name, or a state name, for example \"1099-K\", \"Schedule C\", or \"Ohio\"."
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "start_return",
  "kind": "act",
  "impl": "imperative",
  "description": "Open FreeTaxUSA's sign-in site to start a tax return, in this tab. product picks the starting point: a new 2025 return, one with Deluxe, Pro Support or Audit Defense added, an extension, an amended return, a prior-year return, or a paid-preparer return. The person signs in or creates an account there themselves.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product": {
        "type": "string",
        "enum": [
          "new",
          "deluxe",
          "pro_support",
          "audit_defense",
          "extension",
          "amended",
          "prior_year",
          "paid_preparer"
        ],
        "description": "What to start. Use \"new\" for an ordinary current-year return."
      },
      "year": {
        "type": "integer",
        "description": "Tax year, only for prior_year (default 2024) or amended (default 2025)."
      }
    },
    "required": [
      "product"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "sign_in",
  "kind": "act",
  "impl": "imperative",
  "description": "Open FreeTaxUSA's sign-in site in this tab so the person can sign in and continue a 2025 return they already started. The password and any verification code go into that page directly, from the person, a password manager or a passkey, never through this conversation.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "recover_account",
  "kind": "act",
  "impl": "imperative",
  "description": "Open FreeTaxUSA's account recovery page in this tab, for a person who forgot their username or password or can't sign in. The person answers the recovery questions there; recovery codes and the new password go into that page directly, never through this conversation.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "open_account_page",
  "kind": "act",
  "impl": "imperative",
  "description": "Open a page inside the person's FreeTaxUSA account, in this tab, after they sign in: check their e-file status, contact customer support, print or download a return they filed, or refer a friend. The browser goes to the sign-in site first; the person signs in themselves.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "page": {
        "type": "string",
        "enum": [
          "check_efile_status",
          "contact_support",
          "print_return",
          "refer_a_friend"
        ],
        "description": "Which account page to open after sign-in."
      }
    },
    "required": [
      "page"
    ],
    "additionalProperties": false
  },
  "page": "/"
}