Nutrient DWS MCP Server

A Model Context Protocol (MCP) server implementation that integrates with the Nutrient Document Web Service (DWS) Processor API, providing powerful

Local serverstdioPython

What is the Nutrient DWS MCP server?

Most browser automation work still happens through a UI a human drives. Nutrient DWS MCP server moves it into the conversation instead. A Model Context Protocol (MCP) server implementation that integrates with the Nutrient Document Web Service (DWS) Processor API, providing powerful PDF processing capabilities for AI assistants.

The short version

A Model Context Protocol (MCP) server that connects AI assistants to the Nutrient Document Web Service (DWS) Processor API — enabling document creation, editing, conversion, digital signing, OCR, redaction, and more through natural language.

  • Local stdio MCP server for Claude Desktop and other MCP-compatible clients
  • Browser-based OAuth on the first request that uses the Nutrient API, with optional API-key fallback for CI and headless environments
  • Document conversion, OCR, extraction, redaction, watermarking, annotation flattening, and digital signing
  • Sandbox-aware local file handling with explicit output paths
  • Read-only account lookup for DWS credits and usage

The tools it exposes

The server publishes 9 tools. What each one is for:

  • document_processor — Document processing for conversions, OCR, watermarking, rotation, annotation flattening, and redaction workflows
  • parse_document — Structured data extraction (DWS Data Extraction API): typed JSON elements with bounding boxes and confidence, or whole-document Markdown
  • extract_fields — Schema-guided field extraction (DWS Data Extraction API): pulls specific named fields into a JSON shape you define, with per-field citations
  • document_signer — PDF signing with CMS / PKCS#7 and CAdES signatures plus visible or invisible appearance options
  • ai_redactor — AI redaction for detecting and permanently removing sensitive content such as names, addresses, SSNs, emails, and custom criteria
  • check_credits — Read-only account lookup for current DWS credits and usage. No document content is uploaded
  • sandbox_file_tree — Read-only view of files inside the configured sandbox directory
  • directory_tree — Read-only view of local files when sandbox mode is disabled. Sandbox mode is strongly recommended
  • Authentication — The server authenticates to the Nutrient DWS API (https://api.nutrient.io) using one of:

What it needs from you

Configuration is passed through the environment: SANDBOX_PATH, NUTRIENT_DWS_API_KEY, NUTRIENT_DWS_EXTRACTION_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

The server ships on npm as @nutrient-sdk/dws-mcp-server, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

This sits in the browser automation group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Nutrient DWS's toolset — document_processor, parse_document, extract_fields and 6 more — is a fair guide to whether it matches your workflow. It is maintained by PSPDFKit; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Nutrient DWS.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
document_processorDocument processing for conversions, OCR, watermarking, rotation, annotation flattening, and redaction workflows
parse_documentStructured data extraction (DWS Data Extraction API): typed JSON elements with bounding boxes and confidence, or whole-document Markdown
extract_fieldsSchema-guided field extraction (DWS Data Extraction API): pulls specific named fields into a JSON shape you define, with per-field citations
document_signerPDF signing with CMS / PKCS#7 and CAdES signatures plus visible or invisible appearance options
ai_redactorAI redaction for detecting and permanently removing sensitive content such as names, addresses, SSNs, emails, and custom criteria
check_creditsRead-only account lookup for current DWS credits and usage. No document content is uploaded
sandbox_file_treeRead-only view of files inside the configured sandbox directory
directory_treeRead-only view of local files when sandbox mode is disabled. Sandbox mode is strongly recommended
AuthenticationThe server authenticates to the Nutrient DWS API (https://api.nutrient.io) using one of:

How to install the Nutrient DWS MCP server

{
  "mcpServers": {
    "nutrient-dws": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/dws-mcp-server"],
      "env": {
        "SANDBOX_PATH": "/your/sandbox/directory",
        // "C:\\your\\sandbox\\directory" for Windows
        // Optional for CI or headless usage:
        // "NUTRIENT_DWS_API_KEY": "YOUR_API_KEY_HERE"
      },
    },
  },
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SANDBOX_PATHFilesystem location the server is allowed to use.Optional
NUTRIENT_DWS_API_KEYCredential the server authenticates with.Yes
NUTRIENT_DWS_EXTRACTION_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Nutrient DWS to document processor.
  • Use Nutrient DWS to parse document.
  • Use Nutrient DWS to extract fields.

Frequently asked questions

Browser-based OAuth on the first API request, with an optional `NUTRIENT_DWS_API_KEY` environment variable for CI or headless environments.