{
  "name": "com.fileustaxes/fileustaxes",
  "title": "File US Taxes",
  "version": "1.0.0",
  "description": "Federal tax return preparation for US residents (except Oregon and Nevada) and US citizens abroad, in English and Spanish. Tools: check eligibility, read fixed prices, join the 2027 waitlist, and get approved FAQ answers. No tax or identity data is accepted or stored. A tax preparer reviews every return.",
  "websiteUrl": "https://fileustaxes.com/agents/",
  "documentation": "https://fileustaxes.com/agents/",
  "openapi": "https://fileustaxes.com/openapi.json",
  "contact": {
    "email": "info@fileustaxes.com"
  },
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://fileustaxes.com/mcp"
    }
  ],
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://fileustaxes.com/mcp"
  },
  "protocolVersions": [
    "2025-11-25",
    "2025-06-18"
  ],
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": false
  },
  "languages": [
    "en",
    "es"
  ],
  "dataPolicy": "Read-only tools except start_signup (adds a waitlist entry only after the person consents). No tax data, Social Security numbers or documents are accepted. Identity, consent, engagement letter and payment stay with the person, in the client portal when it opens.",
  "lastReviewed": "2026-11-18",
  "tools": [
    {
      "name": "check_eligibility",
      "title": "Check eligibility",
      "description": "Check whether File US Taxes can prepare a federal return. Pass a two-letter US state code of the person's residence, or abroad=true for a US citizen living abroad. Returns eligible true or false. Does not take or return tax or identity data.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "state": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "Two-letter US state code of the person's residence, for example CA. Omit when abroad is true."
          },
          "abroad": {
            "type": "boolean",
            "description": "true only when the person is a US citizen living outside the United States. The preparer confirms identity and U.S. tax residency status later."
          }
        },
        "anyOf": [
          {
            "required": [
              "state"
            ]
          },
          {
            "required": [
              "abroad"
            ]
          }
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_prices",
      "title": "Get prices",
      "description": "Return the fixed USD prices for federal return preparation, with early and regular rates, the no-meeting and 30-minute-meeting options, and the early-rate end date. Same data as fileustaxes.com/services.json and /pricing/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "lang": {
            "type": "string",
            "enum": [
              "en",
              "es"
            ],
            "description": "en or es. Default en."
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "start_signup",
      "title": "Join the waitlist",
      "description": "Add a person to the File US Taxes waitlist for the 2027 season (the firm emails them when filing opens). Only call after the person has typed their own name and email and said yes; set consent to true only then. Refuses Oregon and Nevada residents. Do not put tax documents, Social Security numbers or account numbers in any field. Identity checks, the engagement letter, consent to file and payment are done by the person in the client portal when it opens, never by this tool.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The person's name, as they typed it."
          },
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 200,
            "description": "The person's email address, as they typed it."
          },
          "filing_type": {
            "type": "string",
            "enum": [
              "individual",
              "married",
              "self-employed",
              "business",
              "abroad",
              "other"
            ],
            "description": "Their filing situation."
          },
          "meeting": {
            "type": "string",
            "enum": [
              "no-meeting",
              "meeting",
              "unsure"
            ],
            "description": "no-meeting, meeting (30 minutes with the preparer), or unsure. Default unsure."
          },
          "lang": {
            "type": "string",
            "enum": [
              "en",
              "es"
            ],
            "description": "en or es. Default en."
          },
          "state": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "Two-letter US state code of the person's residence, for example CA. Omit when abroad is true."
          },
          "abroad": {
            "type": "boolean",
            "description": "true only when the person is a US citizen living outside the United States. The preparer confirms identity and U.S. tax residency status later."
          },
          "consent": {
            "type": "boolean",
            "description": "Must be true, and only after the person agrees to join the waitlist."
          }
        },
        "required": [
          "name",
          "email",
          "filing_type",
          "consent"
        ],
        "anyOf": [
          {
            "required": [
              "state"
            ]
          },
          {
            "required": [
              "abroad"
            ]
          }
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "ask_tiny",
      "title": "Ask Tiny (FAQ)",
      "description": "Answer a general question about File US Taxes from the approved FAQ library only (no generated answers). Returns matching FAQ answers with a link to the FAQ and to the Tiny chat page, or a fallback when nothing matches. Do not send personal or tax details.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "question": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300,
            "description": "A general question, for example: how much does it cost?"
          },
          "lang": {
            "type": "string",
            "enum": [
              "en",
              "es"
            ],
            "description": "en or es. Default en."
          }
        },
        "required": [
          "question"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    }
  ]
}
