About DocRaptor MCP by usefulapi
DocRaptor MCP by usefulapi is a hosted MCP server that creates PDF and Excel files from HTML or URLs and reports asynchronous job status. It is for Claude, Cursor, and other MCP clients, using the user's DocRaptor API key.
Key features
- 01Create documents from HTML or URLs
- 02Generate PDF, XLS, or XLSX files
- 03Check asynchronous job status
- 04List created documents
Use cases
- 01Convert HTML content into a PDF
- 02Generate an Excel file from a webpage URL
- 03Track document generation and review its history
MCP support
The hosted MCP server exposes document creation, asynchronous status checks, document listing, and DocRaptor IP address lookup to clients.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://docraptor.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-docraptor https://docraptor.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-docraptor":{"type":"http","url":"https://docraptor.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-docraptor":{"type":"http","url":"https://docraptor.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-docraptor":{"type":"http","url":"https://docraptor.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-docraptor":{"serverUrl":"https://docraptor.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| tag | string | No | An arbitrary tag string for your own reporting/grouping. |
| name | string | No | A name for the document (<=200 chars), shown in the DocRaptor dashboard/listing. |
| test | boolean | No | If true, generate a FREE watermarked test document (does not consume credits). Default false = a real, BILLED document. |
| type | enum | No | Output format: pdf (default), xls, or xlsx.pdf | xls | xlsx |
| async | boolean | No | If true, enqueue the job and return a status_id (poll with docraptor_get_document_status). Best for large/slow documents. Default false. |
| hosted | boolean | No | If true (default), DocRaptor hosts the file and returns a download_url. If false, the raw document is returned as base64. |
| pipeline | string | No | Rendering pipeline/engine version, e.g. '10'. Omit to use DocRaptor's default. |
| document_url | string | No | A URL DocRaptor will fetch and render. Use this OR document_content. |
| prince_options | object | No | PDF engine (Prince) options. PDF only. |
| prince_options.media | enum | No | CSS media type. "print" (default) vs "screen".print | screen |
| prince_options.baseurl | string | No | Base URL for resolving relative asset paths in document_content. |
| prince_options.pdf_title | string | No | Title metadata embedded in the PDF. |
| prince_options.javascript | boolean | No | Run JavaScript in the document before rendering. Default false. |
| prince_options.max_passes | integer | No | Max Prince layout passes (for JS-driven layouts). |
| document_content | string | No | The HTML/XML source to render. Use this OR document_url. |
| hosted_expires_at | string | No | For hosted docs: ISO 8601 datetime when the hosted link expires. |
| hosted_download_limit | integer | No | For hosted docs: max number of downloads before the link expires. |
Details
From the project READMEDocRaptor MCP by usefulapi
Generate PDF & Excel documents from HTML or a URL, from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your DocRaptor API key.
Live endpoint: https://docraptor.usefulapi.io/mcp · Homepage: https://usefulapi.io/docraptor
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://docraptor.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http docraptor https://docraptor.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"docraptor": {
"url": "https://docraptor.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your DocRaptor credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/docraptor/
On first connect you'll paste your DocRaptor API key. It's validated, stored per-user, and scoped to you.
Tools
| Tool | Type | What it does |
|---|---|---|
docraptor_create_document | write | Create a document (PDF/XLS/XLSX) |
docraptor_get_document_status | read | Get async document status |
docraptor_list_documents | read | List documents |
docraptor_list_ip_addresses | read | List DocRaptor IP addresses |
docraptor_usage_status | meta | Usage status (free-tier meter) |
docraptor_request_feature | meta | Request a missing feature |
docraptor_upgrade | meta | Upgrade to Pro (unlimited*) |
docraptor_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with docraptor_upgrade (it returns a Stripe Checkout link). Cancel any time with docraptor_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running docraptor_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT — see LICENSE. Documentation only; the server is hosted.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.