{
  "markdown": "# @documentero/mcp\n\nOfficial [MCP](https://modelcontextprotocol.io) server for [Documentero](https://www.documentero.com) — list templates, inspect field schemas, and generate Word/PDF/Excel documents from AI agents (Cursor, Claude Desktop, and more).\n\n- **npm:** [`@documentero/mcp`](https://www.npmjs.com/package/@documentero/mcp)\n- **Source:** [github.com/documentero/documentero-mcp](https://github.com/documentero/documentero-mcp)\n- **Website:** [documentero.com](https://documentero.com/)\n- **Docs:** [docs.documentero.com](https://docs.documentero.com/documentation)\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_templates` | Templates with `kind` (word\\|excel), `defaultFormat`, `allowedFormats` |\n| `get_template_fields` | JSON Schema (primary, enriched value rules) + field definitions + allowed formats |\n| `generate_document` | Generate Word/PDF or Excel document for given template and fields; signed URL (~1h) by default, or base64 if `embed: true`. `format` optional (template default). |\n\n## Setup\n\n1. Copy your API key from Documentero → Account settings.\n2. Add the MCP server to your client config.\n\n### Cursor / Claude Desktop (npx)\n\n```json\n{\n  \"mcpServers\": {\n    \"documentero\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@documentero/mcp\"],\n      \"env\": {\n        \"DOCUMENTERO_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Local development\n\n```bash\ngit clone https://github.com/documentero/documentero-mcp.git\ncd documentero-mcp\nnpm install\nnpm run build\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"documentero\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/documentero-mcp/dist/index.js\"],\n      \"env\": {\n        \"DOCUMENTERO_API_KEY\": \"your-api-key\",\n        \"DOCUMENTERO_BASE_URL\": \"https://app.documentero.com/api\"\n      }\n    }\n  }\n}\n```\n\nUse `https://documentero-dev.web.app/api` for the development environment.\n\n## Environment\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `DOCUMENTERO_API_KEY` | yes | — | Company API key ([Account settings](https://app.documentero.com)) |\n| `DOCUMENTERO_BASE_URL` | no | `https://app.documentero.com/api` | Cloud API base URL |\n\n## Typical agent flow\n\n1. `list_templates` → pick a `templateId` (respect `kind` / `allowedFormats`)\n2. `get_template_fields` → shape `data` from **`jsonSchema`** (use `fieldDefinitions` for extra context like HTML/Markdown/image/link/QR rules)\n3. `generate_document` → download URL (or embedded base64)\n\n## Smoke test\n\n```bash\nnpm run build\nDOCUMENTERO_API_KEY=your-key npm run smoke\n```\n\n## Notes\n\n- Thin client of the public Cloud API (`/api/templates`, `/api/meta`, `/api/generate`). Quotas and rate limits are enforced by Documentero as usual.\n- Do not put the API key in tool arguments — keep it in MCP env only.\n- Word templates support output format: `docx` / `pdf`; Excel templates support output format: `xlsx` only.\n- Remote Streamable HTTP hosting (`https://mcp.documentero.com/mcp`) is planned; this release is **stdio only**.\n\n## License\n\nMIT © Documentero\n",
  "bytes": 3063,
  "sha": "8a01ebec267edd1a4e2a365420750ccc5f3d08454a95a494cda18080e83ee562",
  "repo_slug": "documentero/documentero-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_documentero_documentero_mcp_0ad63894/readme"
}