# docweave/mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/NicolasMartalog/docweave-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 437  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/docweave-mcp

## Description
Generate and read PDFs for AI agents: a generatepdf tool (HTML, a URL, or a template + JSON → PDF) and a readpdf tool (a PDF → text/markdown). Run locally with npx @docweave/mcp or use the hosted streamable-HTTP endpoint. Chromium-rendered, priced per document.

## Tools
Capabilities this server exposes over MCP:

- **generate_pdf** — `source` (one of: raw `html`, a public `url`, or a `template` + `data`) → a PDF.
- **read_pdf** — `source` (`url` or `base64`) → extracted `content` (markdown or text) + `pageCount`.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What docweave/mcp MCP server does

The docweave/mcp MCP server provides two document-focused tools through the Model Context Protocol: `generate_pdf` and `read_pdf`. It is the MCP package for Docweave and is intended for clients such as Claude Desktop, Cursor, and Windsurf.

`generate_pdf` creates a PDF from one of three inputs: raw HTML, a public URL, or a template together with JSON data. Page settings can optionally specify the paper format, landscape mode, and margins. Rendering uses Chromium, so the tool is suited to producing PDFs from web-oriented document content.

`read_pdf` accepts a PDF URL or base64-encoded PDF data. It returns extracted content as text or Markdown, along with the document's page count. For scanned or image-only PDFs, the response reports `needsOcr: true` rather than returning empty extracted text.

## How it works

An MCP client invokes either tool and supplies a structured `source` value. For PDF generation, the source identifies HTML, a public URL, or a template and its associated data. For PDF reading, the source identifies a URL or base64 content. The generated document or extracted result is returned to the client through MCP.

URL-based rendering is restricted by SSRF protections, and generation supports idempotency keys. The hosted service is available at `https://docweave.dev/api/mcp`. Requests sent to that hosted API require a Docweave bearer API key.

## Setup and configuration

The docweave/mcp MCP server can run locally from the published npm package with:

```bash
npx -y @docweave/mcp
```

A Claude Desktop configuration can register it as a local stdio server using `npx` and the `-y` flag. The package includes its render engine, so the documented installation does not require a separate Chromium setup.

Alternatively, an MCP client can use the hosted streamable-HTTP endpoint without installing the package. Hosted calls authenticate with a Docweave API key in the `Authorization: Bearer ...` header. The README states that a free account includes 50 documents per month without a card; usage is priced per document rather than per page.

## Tools and capabilities

- Generate PDFs from raw HTML.
- Render a public URL as a PDF.
- Populate a template with JSON data before PDF generation.
- Set PDF format, orientation, and margins.
- Read PDFs from URLs or base64 input.
- Return extracted text or Markdown and a page count.
- Flag scanned documents that need OCR.

## Limitations and notes

The URL input for generation must be public, and URL rendering includes SSRF protections. The documented reading behavior identifies scanned PDFs with `needsOcr`; it does not state that OCR is performed by the server. Hosted use requires a Docweave API key, while the README does not specify a separate credential requirement for the local command. Pricing information in the source applies to Docweave document processing, not to the open-source package itself.

The docweave/mcp MCP server is licensed under MIT. Its repository is the source for the `@docweave/mcp` npm package, and the package is also listed in the official MCP registry.

_Full upstream README: https://allmcps.com/mcp/docweave-mcp/readme_