{
  "markdown": "# Dokmatiq DocGen SDKs\n\n[![CI TypeScript](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-typescript.yml/badge.svg)](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-typescript.yml)\n[![CI Python](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-python.yml/badge.svg)](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-python.yml)\n[![CI Java](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-java.yml/badge.svg)](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-java.yml)\n[![CI .NET](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-dotnet.yml/badge.svg)](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-dotnet.yml)\n[![CI PHP](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-php.yml/badge.svg)](https://github.com/dokmatiq/docgen-sdks/actions/workflows/ci-php.yml)\n\nOfficial SDKs for the [Dokmatiq DocGen API](https://developer.dokmatiq.com) -- document generation, e-invoicing, Excel workbooks, receipt recognition, and PDF tools in a single API.\n\nDokmatiq DocGen also includes an MCP server and AI assistant skill for Codex and Claude Code to create PDFs, invoices, e-invoices, ZUGFeRD/XRechnung documents, and documents on company letterhead (Briefpapier/Firmenpapier).\n\n## SDKs\n\n| Language | Package | Install |\n|----------|---------|---------|\n| **TypeScript** | [`@dokmatiq/docgen`](typescript/) | `npm install @dokmatiq/docgen` |\n| **Python** | [`dokmatiq-docgen`](python/) | `pip install dokmatiq-docgen` |\n| **Java** | [`com.dokmatiq:docgen-sdk`](java/) | Maven / Gradle |\n| **PHP** | [`dokmatiq/docgen-sdk`](php/) | `composer require dokmatiq/docgen-sdk` |\n| **C# / .NET** | [`Dokmatiq.DocGen`](dotnet/) | `dotnet add package Dokmatiq.DocGen` |\n\nAlso included: [MCP Server](mcp/) for AI assistants (any MCP client — Claude Desktop, Cursor, Continue, Cline, …) and a [Codex / Claude Code plugin and skill](plugin/) (MCP setup plus a triggering `dokmatiq-docgen` skill).\n\n## AI Assistant Install\n\nUse the Dokmatiq DocGen MCP server with Codex, Claude Code, Claude Desktop, Cursor, Continue, Cline, Hermes, or any other MCP-capable client.\n\n### Codex Skill\n\nInstall the skill from this repo path:\n\n```bash\npython3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \\\n  --repo dokmatiq/docgen-sdks \\\n  --path plugin/skills/dokmatiq-docgen\n```\n\nThen install and configure the MCP server:\n\n```bash\npython3.11 -m pip install --user dokmatiq-docgen-mcp\nexport DOCGEN_API_KEY=\"dk_live_xxxxxxxxxxxxx\"\n```\n\nIf `docgen-mcp` is installed into `~/.local/bin`, make sure that directory is on your `PATH`, or configure your MCP client with the absolute command path.\n\n### Claude Code Plugin\n\n```bash\n/plugin marketplace add dokmatiq/claude-plugins\n/plugin install docgen@dokmatiq\n```\n\nThe legacy plugin copy in this repository is kept under [`plugin/`](plugin/) for backwards compatibility.\n\n---\n\n## Features\n\nAll SDKs provide the same capabilities with idiomatic APIs:\n\n### Document Generation\nHTML, Markdown, and ODT templates to PDF, DOCX, or ODT -- with field substitution, images, QR codes, tables, watermarks, and stationery overlays.\n\n### E-Invoicing (ZUGFeRD / XRechnung)\nEmbed and extract structured invoice data in PDF invoices (EN16931). Generate, parse, validate, and transform XRechnung XML (CII and UBL).\n\n### Excel Workbooks\nCreate styled XLSX from JSON with formulas, freeze panes, auto-filters, and cell styling. Convert between XLSX, CSV, and JSON. Fill Excel templates.\n\n### Receipt Recognition (AI-Powered)\nExtract structured data from receipt and invoice images:\n\n- **Vendor, date, totals** (gross / net / VAT per rate)\n- **Line items** with quantity, unit price, and total\n- **SKR03/04 account mapping** for German bookkeeping\n- **Multi-currency support** with exchange rates\n- **DATEV-compatible CSV export**\n- **Confidence score** for extraction quality\n- **Async processing** for large batches\n\n```typescript\nconst result = await dg.receipts.extract(\"receipt.jpg\");\n// { vendor, date, total: { gross, net, vat }, skr03Account, lineItems, confidence, ... }\n\nconst csv = await dg.receipts.exportDatev([result]);\n```\n\n### PDF Operations\nMerge, split, rotate, extract text, read/write metadata, convert to PDF/A.\n\n### Digital Signatures\nSign PDFs with PKCS#12 certificates. Verify existing signatures.\n\n### PDF Forms\nInspect and fill PDF form fields programmatically.\n\n### Preview\nRender PDF pages as PNG images for thumbnails and previews.\n\n### Async Processing\nSubmit long-running jobs with polling or webhook callbacks.\n\n---\n\n## Quick Start\n\n```bash\n# 1. Get an API key at https://developer.dokmatiq.com\n# 2. Install your SDK of choice\n\nnpm install @dokmatiq/docgen          # TypeScript\npip install dokmatiq-docgen           # Python\ncomposer require dokmatiq/docgen-sdk  # PHP\ndotnet add package Dokmatiq.DocGen    # .NET\n# Maven: com.dokmatiq:docgen-sdk     # Java\n```\n\n```typescript\nimport { DocGen } from \"@dokmatiq/docgen\";\n\nconst dg = new DocGen({ apiKey: \"your-api-key\" });\n\n// Generate a PDF\nconst pdf = await dg.htmlToPdf(\"<h1>Hello World</h1>\");\n\n// Build a complex document\nconst doc = await dg.document()\n  .html(\"<h1>Invoice {{nr}}</h1>\")\n  .field(\"nr\", \"RE-2026-001\")\n  .watermark(\"DRAFT\")\n  .asPdf()\n  .generate();\n\n// Extract receipt data\nconst receipt = await dg.receipts.extract(\"receipt.jpg\");\n\n// Create an Excel workbook\nconst xlsx = await dg.excel.generate({\n  sheets: [{ name: \"Report\", columns: [...], rows: [...] }]\n});\n```\n\n---\n\n## Documentation\n\n- [Developer Portal](https://developer.dokmatiq.com) -- Sign up, API keys, usage dashboard\n- [API Reference](https://docs.dokmatiq.com) -- Full REST API docs\n- [Website](https://dokmatiq.com) -- Product overview\n\nEach SDK has its own detailed README with full examples:\n[TypeScript](typescript/) | [Python](python/) | [Java](java/) | [PHP](php/) | [.NET](dotnet/)\n\n---\n\n## License\n\n[MIT](LICENSE) -- Copyright 2026 Dokmatiq\n",
  "bytes": 5951,
  "sha": "df0dd6e9fa0f5145ab582d0d2c47506f9197db560804dc319eceea3c940af988",
  "repo_slug": "dokmatiq/docgen-sdks",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dokmatiq_docgen_175fffed/readme"
}