developer-toolsapi_key

Nutrient Document Web Services API

Process, convert, OCR, redact, sign, and analyze documents with Nutrient Document Web Services.

Verdict

The Nutrient Document Web Services API lets your team generate, convert, and manipulate PDFs without leaving Switchy. @mention it to turn Markdown into styled PDFs, render web pages as documents, or combine remote files into a single output — all inline in a Project. Developers and ops teams use it to prototype document workflows, estimate API costs before committing, and troubleshoot production jobs. The MCP exposes 13 tools including build, convert, and account-monitoring endpoints. You'll need an API key from Nutrient's dashboard; the free tier covers light experimentation but production volume requires a paid subscription.

Common use cases

  • Prototype PDF generation workflows before writing code
  • Convert meeting notes from Markdown to PDF
  • Render live web pages as archival documents
  • Estimate API costs for batch document jobs
  • Troubleshoot production document pipeline errors

Integration

Vendor
Nutrient Document Web Services API
Category
developer-tools
Auth
API_KEY
Tools
13
Composio slug
nutrient_document_web_services_api

Tools

  • Analyze Build Cost

    Estimate the credits and Processor features required by Build API instructions without executing the document job or consuming credits.

  • Analyze Build Request (Deprecated)

    Deprecated compatibility tool for the original ANALYZE_BUILD contract. Use ANALYZE_BUILD_COST for typed Build instructions.

  • Build Document

    Synchronously create one document from remote files, remote HTML, new pages, and composable safe actions, returning its filename, media type, and Base64 content up to 4 MB. Use this for multi-part or multi-step workflows; applied redaction

  • Convert Markdown to PDF

    Convert CommonMark or GitHub-Flavored Markdown text into a PDF using optional built-in styling, custom CSS, page layout, and syntax highlighting settings. Returns the filename, media type, and Base64 content up to 4 MB. This consumes Proces

  • Create JWT Token

    Create a short-lived restricted Nutrient bearer token. This compatibility tool returns secret credential material; revoke it with REVOKE_JWT_TOKEN when it is no longer needed. Prefer the connected API key for normal server-side document pro

  • Create PDF from Web Page

    Render an HTML web page at a public URL, with optional page layout settings, into a PDF. Returns the filename, media type, and Base64 content up to 4 MB. This consumes Processor credits; check GET_PROCESSOR_USAGE first. Free-tier output may

  • Get Account Information

    Return the connected Nutrient account's subscription type, status, and estimated remaining credits.

  • Get Processor Usage

    Return the connected account's Processor subscription status and credit usage counters.

  • Make PDF Accessible

    Auto-tag a PDF at a remote URL for PDF/UA screen-reader accessibility and return the result's filename, media type, and Base64 content up to 4 MB. This consumes Processor credits; check GET_PROCESSOR_USAGE first. Free-tier output may be wat

  • OCR PDF

    Apply optical character recognition to a PDF at a remote URL and return a searchable PDF's filename, media type, and Base64 content up to 4 MB. This consumes Processor credits; check GET_PROCESSOR_USAGE first. Free-tier output may be waterm

  • Revoke JWT Token
    destructive

    Immediately revoke a bearer token created by CREATE_JWT_TOKEN using its ID. Use this when a generated token is no longer needed or may be compromised.

  • Stage PDF Redactions

    Find matching content in a remote PDF and return a review PDF's filename, media type, and Base64 content up to 4 MB with unapplied redaction marks. This action cannot permanently apply redactions. It consumes Processor credits; check GET_PR

  • Watermark PDF

    Add a positioned text or image watermark to every page of a PDF at a public URL and return the copy's filename, media type, and Base64 content up to 4 MB. This consumes Processor credits; check GET_PROCESSOR_USAGE first. Free-tier output ma

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations > Developer Tools. 2. Click 'Connect' next to Nutrient Document Web Services API. 3. Log into your Nutrient account at nutrient.io, go to API Keys, and generate a new key with full Processor permissions. 4. Paste the key into Switchy's connection dialog and click 'Authorize'. 5. Switchy confirms the connection by fetching your account info; you'll see your subscription tier and remaining credits. 6. Open any Project, type '@Nutrient' in the chat, and ask it to convert a Markdown snippet into a PDF — the tool returns a Base64-encoded document you can download or preview. 7. Check your credit balance anytime by @mentioning Nutrient and asking for account information.

What teammates see: by default, memories from Nutrient Document Web Services API are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Markdown to Styled PDF

@Nutrient convert this Markdown to PDF with GitHub-flavored syntax highlighting and A4 landscape layout: [paste your Markdown here]

Web Page to PDF Archive

@Nutrient render https://example.com/pricing as a PDF with letter-size pages and 0.5-inch margins

Estimate Build Job Cost

@Nutrient estimate the cost to merge three remote PDFs at [URL1], [URL2], [URL3] into one document

Check Credit Balance

@Nutrient show my current Processor credit balance and subscription tier

Build Multi-Part Document

@Nutrient build a PDF from [remote-file-URL], a blank page, then [another-remote-file-URL], and return the Base64 output

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Nutrient what would it cost in credits to merge these three contract PDFs, add a watermark, and flatten all the form fields?

Output

Based on the Build API instructions you described, this job would consume approximately 45 credits. The breakdown: merging three documents (15 credits), applying a watermark to each page (20 credits), and flattening form fields (10 credits). Your account currently has 8,240 credits remaining on the Professional plan. This is an estimate only — the actual cost depends on page count and document complexity. No credits were consumed by this analysis.

Notes

This example uses the Analyze Build Cost tool to preview credit consumption before executing an expensive multi-step document operation. Useful for budget-conscious workflows where you need cost visibility upfront. Requires a valid API key with access to the Processor API; the estimate assumes typical document sizes and may vary by 10–15% in practice.

Prompt

@Nutrient convert this markdown spec into a PDF with syntax highlighting and our brand CSS, then return the file so I can attach it to the release email.

Output

I've converted your markdown specification to PDF using GitHub-Flavored Markdown parsing, applied syntax highlighting for the code blocks, and injected the custom CSS you provided. The resulting PDF is 12 pages, A4 portrait layout. File returned: technical-spec-v2.1.pdf (842 KB, Base64-encoded). This operation consumed 8 Processor credits. You can decode the Base64 content and attach it directly to your email client or upload it to your file storage.

Notes

This example demonstrates the Convert Markdown to PDF tool with custom styling. The MCP returns the full PDF as Base64 content (up to 4 MB), so you can immediately use it downstream without a separate download step. Be aware that large documents may hit the 4 MB response limit; for bigger files, consider using the asynchronous Build API instead.

Prompt

@Nutrient check my account status and tell me if I have enough credits left to process 200 invoice PDFs this month with OCR and text extraction.

Output

Your Nutrient account is on the Business plan, active and in good standing. You currently have 12,450 credits remaining this billing cycle (resets in 18 days). Processing 200 invoices with OCR and text extraction typically consumes 15–20 credits per document, so you'd need approximately 3,000–4,000 credits total. You have sufficient headroom for this batch. If you exceed your limit, overage billing applies at $0.02 per credit on your plan tier.

Notes

This example pairs the Get Account Information and Get Processor Usage tools with the AI's reasoning to answer a capacity-planning question. The credit-per-document estimate is illustrative and depends on page count, image resolution, and OCR complexity. Always test a sample batch first to refine your cost model before committing to large-scale processing.

Use-case deep-dives

Contract generation in sales workflow

When Nutrient wins for high-volume proposal assembly

A 6-person sales team closes 40 deals a month, each needing a custom contract PDF assembled from pricing tables, legal boilerplate, and client-specific terms. Nutrient's Build Document tool is the right call here because it composes multi-part documents from remote files and new pages in one synchronous call, returning Base64 content under 4MB without touching your filesystem. The Analyze Build Cost tool lets the team pre-flight each job to confirm credit usage before execution, which matters when you're burning through hundreds of documents monthly. The threshold: if your contracts regularly exceed 4MB or you need asynchronous processing for 100+ page documents, you'll hit the size ceiling and need a different approach. For typical B2B contracts under 50 pages, this MCP keeps document assembly inside your Switchy workspace without managing storage or webhooks.

Technical documentation publishing

Markdown-to-PDF for developer docs at ship time

A 3-person developer relations team ships SDK documentation every two weeks, converting 20-30 Markdown files into styled PDFs for offline distribution. Nutrient's Convert Markdown to PDF tool handles this cleanly because it supports GitHub-Flavored Markdown with syntax highlighting and custom CSS, returning ready-to-ship PDFs in one call. The team uses Get Account Information to monitor credit burn during release sprints when doc volume spikes. This works when your Markdown is already the source of truth and you need consistent styling across all outputs. The trade-off: if your docs include complex interactive examples or need per-page layout control beyond CSS, the Markdown converter won't cut it and you'll need the full Build Document tool or a different rendering stack. For straightforward technical writing that lives in Markdown, this is the fastest path from commit to PDF.

Customer support screenshot archival

When web-to-PDF capture fits support ticket workflows

A 5-person support team handles 200 tickets a week, many requiring snapshots of customer-reported UI bugs or configuration screens for internal tracking. Nutrient's Create PDF from Web Page tool is borderline here: it renders public URLs into PDFs with layout control, which works for capturing external dashboards or public-facing pages customers reference. The Get Processor Usage tool helps the team track credit consumption against their monthly budget. The limitation is the 'public URL' requirement—if your support flow involves authenticated customer portals or localhost screenshots, this MCP can't reach them and you need a browser automation tool instead. For support teams triaging issues on public SaaS interfaces or documentation pages, this keeps visual evidence inside Switchy without managing headless Chrome. If more than 30% of your captures need auth, skip this and use Playwright or Puppeteer.

Frequently asked

What does the Nutrient Document Web Services MCP do in Switchy?

It lets AI agents generate, convert, and manipulate PDFs programmatically. The MCP wraps Nutrient's API so your team can build documents from HTML, Markdown, or remote files, estimate credit costs before running jobs, and check your account's remaining Processor credits—all without writing integration code yourself.

Do I need a Nutrient account to use this MCP?

Yes. You must supply an API key from an active Nutrient subscription. The MCP calls GET_ACCOUNT_INFORMATION and GET_PROCESSOR_USAGE to surface your plan type and credit balance, so agents know when a job will exceed your quota. Without valid credentials, every tool call fails at the API layer.

Can the MCP edit existing PDFs or only create new ones?

It creates and converts documents; it does not edit PDFs in place. The Build Document tool can compose multi-part files from remote sources and apply safe actions like merging or appending pages, but you cannot open an existing PDF, change a paragraph, and save it back. For inline edits, use Nutrient's client-side SDK instead.

Why use this MCP instead of calling Nutrient's REST API directly?

The MCP handles authentication, Base64 encoding, credit estimation, and error parsing so your AI agents can generate PDFs in a single natural-language request. Calling the REST API yourself means writing and maintaining HTTP clients, managing tokens, and parsing JSON responses—work the MCP already does.

Does PDF generation count against Switchy's usage limits or Nutrient's?

Both. Each MCP tool call consumes one Switchy action credit. Document jobs that hit Nutrient's Processor API also deduct credits from your Nutrient subscription. Use ANALYZE_BUILD_COST before running expensive jobs to see the Nutrient credit estimate; Switchy cannot refund Nutrient credits if a job fails.

More developer tools MCPs

See all developer tools MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.