Skip to content
MCP server

Pdfedit MCP

Edit text inside existing PDFs from an AI agent, keeping fonts and layout

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.1.10
Listing updated
2 days ago

About Pdfedit MCP

Pdfedit MCP is a freemium MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

Rather than regenerating a document, this server sends your PDF to the PDF Edit API, which changes only the words you point at and leaves the embedded fonts and the rest of the page alone. Each edit comes back with a before and after preview, and the API reports a per-change check. According to its site, a change that cannot be verified is rolled back instead of returned.

The package runs on your machine over stdio and uploads local files for you, writing the result next to the original as <name>.edited.pdf. A hosted Streamable HTTP endpoint is also offered for web clients that cannot run a local server, but it accepts PDF URLs only because it cannot read your disk.

Without an API key the server uses a keyless tier of 20 pages a day per IP, with output watermarked TEST. A free key raises this to 200 pages a month. Billing counts only the pages you actually edit, and a page that needs OCR counts as five.

Install

Run in a terminal

claude mcp add --transport http pdfedit-mcp https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdfedit-mcp": {
      "url": "https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pdfedit-mcp": {
      "type": "http",
      "url": "https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdfedit-mcp": {
      "serverUrl": "https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pdfedit-mcp": {
      "type": "http",
      "url": "https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp"
    }
  }
}

Configuration

  • PDFEDIT_API_KEYAPI key for the PDF Edit API. Optional: without one the hosted API serves the keyless free tier (20 pages a day per IP, outputs watermarked TEST).
  • PDFEDIT_BASE_URLGateway base URL. Defaults to http://localhost:8000; set it to the hosted API or to your own deployment.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

pdf_edit
Replace, delete, redact, insert or fill text in a PDF in one call, with previews.
pdf_batch
Apply the same edits once per record over one template; returns a job id.
pdf_find
List every text span with page, bounding box, font and span id, filtered by match mode.
pdf_preview
Render a page or region as a PNG, with optional highlight boxes.
pdf_job
Fetch the result of an async edit or batch.

What it does

Five PDF tools
pdf_edit, pdf_batch, pdf_find, pdf_preview and pdf_job cover editing, batch runs, span lookup, page rendering and async results.
Replace, delete, redact, insert
Edits change text in place, remove it, redact it from the content stream and image pixels, or add new text after an anchor phrase.
Form filling
AcroForm fields can be filled by name, read back and optionally flattened.
Before and after previews
Up to three preview PNGs of the changed pages are returned inline.
Batch mode
One template can be edited once per record, returning a job id to poll.
Local or hosted
Run it with npx on your machine or use the hosted endpoint with PDF URLs.

Good for

  • Update a figure or name in a signed agreement without rebuilding the file
  • Redact card numbers or IBANs so the underlying bytes are removed
  • Fill AcroForm fields in a PDF template from an agent
  • Produce many variants of one PDF template from a list of records
  • Find where a string appears in a PDF along with its page, bounding box and font

Pricing

Freemium, from $9 a month

Free tier of 200 pages a month; Starter $9/mo for 5,000 pages

Prices change. Check api.niubai.vip before you buy.

Pdfedit MCP FAQ

Do I need an API key?

No. Without one the keyless tier allows 20 pages a day per IP and watermarks output with TEST. A free key gives 200 pages a month.

Can it read files from my disk?

The local npx package can; it uploads the file for you. The hosted remote endpoint cannot and only takes PDF URLs.

How is usage billed?

Per page edited, not per page sent. Paid plans listed on the site run from $9 a month for 5,000 pages, and a page needing OCR counts as five.

Which clients does it work with?

Claude Code, Cursor, VS Code and Claude Desktop are named in the setup instructions.

Is Pdfedit MCP free?

Pdfedit MCP has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

How do I add Pdfedit MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http pdfedit-mcp https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp

What are the best alternatives to Pdfedit MCP?

The closest alternatives to Pdfedit MCP are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to Pdfedit MCP

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media