# io.github.cyanheads/docgen-mcp-server (npm · @cyanheads/docgen-mcp-server)

Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs.

- Trust score: 64/100 (medium)
- Change this week: +59
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-07

## Components

- npm · `@cyanheads/docgen-mcp-server`: 64/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-docgen-mcp-server/cyanheads-docgen-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-docgen-mcp-server/cyanheads-docgen-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@cyanheads/docgen-mcp-server`
- Version: `0.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-07.

- **Supply Chain Security**: 88/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects uuid 8.3.2, reached via exceljs > uuid. A fixed version is available.
  - No install/post-install scripts declared.
  - 98 of 212 dependencies flagged as unhealthy (6 deprecated).
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 39 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 66/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 837 tokens (~209/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add cyanheads-docgen-mcp-server -- npx -y @cyanheads/docgen-mcp-server
```

### Codex

```bash
codex mcp add cyanheads-docgen-mcp-server -- npx -y @cyanheads/docgen-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-docgen-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@cyanheads/docgen-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-docgen-mcp-server --command npx --arg -y --arg @cyanheads/docgen-mcp-server
```

### Hermes

```yaml
mcp_servers:
  cyanheads-docgen-mcp-server:
    command: "npx"
    args: ["-y", "@cyanheads/docgen-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-docgen-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/docgen-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-07 (score 64, +3)

- [functional regression] Security disclosure: fail → unverified
- [functional] Dependency health: partial → 0.77

### 2026-08-06 (score 61, +28)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail

### 2026-08-05 (score 33, 0)

- [security improvement] CVE-2026-69207 no longer affects this package

### 2026-08-04 (score 33, 0)

- [security regression] CVE-2026-69207 affects this package: high

### 2026-08-02 (score 33, +28)

- [security regression] CVE-2026-41907 affects this package: high
- [security regression] Provenance: unverified → fail
- [security regression] Known CVEs: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional] Licence: Apache-2.0

### 2026-08-01 (score 5, 0)

- [security] Stability: Stability not yet verified: our sandbox run of this package did not complete, so we have no schema to compare.
- [functional] Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess.
- [functional] Capabilities: Protocol version not yet verified: our sandbox run of this package did not complete, so we never saw its MCP handshake.
- [functional] Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess.

### 2026-07-31 (score 5, −19)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 24, 0)

- [functional] Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess.
- [functional] Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess.

## MCP tools (4)

### `docgen_render_pdf` (~187 tokens)

docgen-mcp-server

Render content to a downloadable PDF document. Provide exactly one source: { html } (raw HTML you compose — the recommended path), { markdown } (converted to HTML then rendered), or { template, data } (a {{key}} template filled from a data object, server-owned layout). Control page size, orientation, margins, header/footer, and page numbers via pageOptions. Returns a delivery envelope with a documentId, resource URI, pageCount, byte size, and inline base64 when small enough. The lightweight engine renders structured layout (headings, paragraphs, lists, tables) but not arbitrary CSS — a degraded flag is set when unsupported styling is dropped.

Input parameters:

- `pageOptions` (object): Page layout options; sensible defaults apply.
- `source` (object, required): The document source — provide exactly ONE of: { html }, { markdown }, or { template, data }.

Output parameters:

- `degraded` (boolean): True when the lightweight engine dropped unsupported styling (CSS, images, scripts).
- `document` (object): Delivery envelope for a rendered document — metadata plus resource/inline byte access.
- `engine` (string): The PDF rendering engine that produced the document.

### `docgen_export_spreadsheet` (~144 tokens)

docgen-mcp-server

Render one or more named worksheets of row objects to a downloadable .xlsx workbook. Each sheet is a name plus an array of row objects (property → scalar), with an optional column spec controlling header label, value type, width, and number/date format. An empty rows array yields a header-only sheet; provide at least one sheet. Returns a delivery envelope with a documentId, resource URI, sheetCount, byte size, and inline base64 when small enough. The natural export stage for tabular data pulled from another server — reshape its rows into sheets[] and render.

Input parameters:

- `sheets` (array, required): One or more named worksheets to render into the workbook.

Output parameters:

- `document` (object): Delivery envelope for a rendered document — metadata plus resource/inline byte access.
- `engine` (string): The rendering engine that produced the workbook.

### `docgen_fill_form` (~248 tokens)

docgen-mcp-server

Fill the AcroForm fields of a supplied PDF and optionally flatten it. Provide the source PDF as exactly one of { base64 } or { url } (an https URL fetched behind an SSRF guard; base64 avoids any fetch), plus a fields map of AcroForm field name → value. Field names must match the PDF internal names exactly (case-sensitive); obtain them from whoever supplied the form, since docgen does not expose them. Names with no AcroForm counterpart come back in unmatchedFields[] rather than failing — correct them and re-render. Set flatten to bake the values in so the result is no longer editable. Returns a delivery envelope with a documentId, resource URI, pageCount, and inline base64 when small enough.

Input parameters:

- `fields` (object, required): AcroForm field name → value. Names must match the PDF internal field names exactly (case-sensitive). Unmatched names are returned in unmatchedFields[].
- `flatten` (boolean): When true, flatten the form after filling so values are baked in and no longer editable.
- `sourcePdf` (object, required): The fillable PDF source — provide exactly ONE of { base64 } or { url }.

Output parameters:

- `document` (object): Delivery envelope for a rendered document — metadata plus resource/inline byte access.
- `unmatchedFields` (array): Field names from the input map that had no matching AcroForm field. Empty when every field matched. Correct these and re-render to fill them.

### `docgen_get_document` (~166 tokens)

docgen-mcp-server

Re-fetch a previously rendered document by the id a docgen render/export/fill tool returned. Returns the same delivery envelope (metadata plus resource URI, and inline base64 when small enough). Use it to recover a document whose inline copy was dropped (over the inline size limit) while it is still within its TTL. The documentId is obtainable ONLY from an earlier docgen_render_pdf, docgen_export_spreadsheet, or docgen_fill_form result — it is not guessable, and an expired or unknown id returns document_expired.

Input parameters:

- `documentId` (string, required): The opaque document id returned by an earlier docgen_render_pdf, docgen_export_spreadsheet, or docgen_fill_form call. Format `doc_` followed by 24 url-safe characters.

Output parameters:

- `document` (object): Delivery envelope for a rendered document — metadata plus resource/inline byte access.

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/cyanheads-docgen-mcp-server/cyanheads-docgen-mcp-server#diagnostics

## Score history

- 2026-08-07: 64
- 2026-08-06: 61
- 2026-08-05: 33
- 2026-08-04: 33
- 2026-08-03: 33
- 2026-08-02: 33
- 2026-08-01: 5
- 2026-07-31: 5
- 2026-07-30: 24
- 2026-07-28: 24
- 2026-07-27: 24

## Links

- npm package: https://www.npmjs.com/package/@cyanheads/docgen-mcp-server
- Socket report: https://socket.dev/npm/package/@cyanheads/docgen-mcp-server
- Repository: https://github.com/cyanheads/docgen-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-docgen-mcp-server/cyanheads-docgen-mcp-server.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-docgen-mcp-server/cyanheads-docgen-mcp-server.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-docgen-mcp-server/cyanheads-docgen-mcp-server