{
  "name": "thelawin",
  "description": "EU-compliant e-invoice generation API. JSON in, valid PDF/A-3 out. Supports ZUGFeRD 2.4, Factur-X, XRechnung, Peppol, FatturaPA, UBL, and CII.",
  "version": "1.0.0",
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json", "application/pdf"],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "supportedInterfaces": [
    {
      "protocolBinding": "JSONRPC",
      "url": "https://api.thelawin.dev"
    }
  ],
  "security": {
    "schemes": [
      {
        "id": "api-key",
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "API key for authenticated access. Sandbox mode works without key (watermarked PDFs)."
      }
    ]
  },
  "skills": [
    {
      "id": "thelawin_generate",
      "name": "Generate E-Invoice PDF",
      "description": "Generate a compliant EU e-invoice (ZUGFeRD, Factur-X, XRechnung, Peppol, FatturaPA, UBL, CII, or PDF) from structured JSON data. Returns a PDF/A-3 with embedded XML.",
      "tags": ["invoice", "e-invoice", "zugferd", "factur-x", "xrechnung", "peppol", "fatturapa", "pdf", "eu-compliance", "en16931"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "examples": [
        "Generate a ZUGFeRD invoice for a German B2B transaction",
        "Create a FatturaPA XML for an Italian client",
        "Generate a Peppol cross-border EU invoice"
      ]
    },
    {
      "id": "thelawin_validate",
      "name": "Validate E-Invoice Data",
      "description": "Pre-validate invoice JSON before generating a PDF. Checks format detection, required fields, and legal compliance warnings. No quota impact.",
      "tags": ["validation", "compliance", "e-invoice"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "examples": [
        "Check if my invoice data is valid for XRechnung",
        "Validate a Peppol invoice before submission"
      ]
    },
    {
      "id": "thelawin_retrieve",
      "name": "Retrieve Invoice Data from PDF",
      "description": "Extract structured invoice data from an existing PDF or XML file. Detects ZUGFeRD, Factur-X, XRechnung, UBL, CII, Peppol, and FatturaPA formats.",
      "tags": ["extraction", "pdf", "e-invoice", "retrieval"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "examples": [
        "Extract invoice data from a ZUGFeRD PDF",
        "Read FatturaPA data from an XML file"
      ]
    }
  ],
  "documentationUrl": "https://docs.thelawin.dev",
  "provider": {
    "name": "thelawin.dev",
    "url": "https://thelawin.dev",
    "contact": "hello@thelawin.dev"
  },
  "mcp": {
    "url": "https://mcp.thelawin.dev",
    "protocolVersion": "2024-11-05",
    "description": "Model Context Protocol endpoint for AI agent integration. Supports thelawin_generate and thelawin_validate tools."
  },
  "llmsTxt": "https://thelawin.dev/llms.txt",
  "openApi": "https://api.thelawin.dev/openapi.yaml"
}