Invoice Reading MCP

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "description": "Original file name with its extension. A name ending in .pdf is parsed as PDF. Any other name, or omitted, is treated as plain text."
    },
    "file_text": {
      "type": "string",
      "description": "Plain invoice text. Send this or file_base64, not a photo. Preferred when the text is already extracted."
    },
    "file_base64": {
      "type": "string",
      "description": "Text PDF, or a .txt file, encoded as base64. Use this instead of file_text when you have the file bytes. Image-only PDFs fail with no_text_extracted and are not charged."
    }
  }
}

{
  "type": "object",
  "required": [
    "credits_remaining",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "properties": {
        "emails": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Up to three email addresses found in the text."
        },
        "method": {
          "type": "string",
          "const": "heuristic"
        },
        "currency": {
          "enum": [
            "HUF",
            "EUR",
            null
          ],
          "type": [
            "string",
            "null"
          ],
          "description": "HUF when Ft or HUF appears, otherwise EUR when EUR appears."
        },
        "confidence": {
          "type": "number",
          "description": "0.45 when a tax id or net amount was found, otherwise 0.2."
        },
        "net_amount": {
          "type": [
            "string",
            "null"
          ],
          "description": "Net amount as a digit string."
        },
        "vat_amount": {
          "type": [
            "string",
            "null"
          ],
          "description": "VAT amount as a digit string."
        },
        "raw_excerpt": {
          "type": "string",
          "description": "First 1500 characters of the extracted text."
        },
        "vendor_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "First non-empty line. Heuristic, often the seller."
        },
        "gross_amount": {
          "type": [
            "string",
            "null"
          ],
          "description": "Gross or total amount as a digit string."
        },
        "invoice_date": {
          "type": [
            "string",
            "null"
          ],
          "description": "First date, as written on the invoice."
        },
        "vendor_tax_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "First Hungarian tax id shaped 12345678-1-23."
        },
        "customer_tax_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "Second tax id of that shape, when present."
        }
      }
    },
    "credits_remaining": {
      "type": "number",
      "description": "Balance after this successful call."
    }
  }
}

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}