English Français العربية

io.github.zp130221/pdfedit-mcp

Official registry Other

Edit text inside existing PDFs: replace, delete, redact, insert, fill forms; original fonts kept.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http pdfedit-mcp 'https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pdfedit-mcp": {
            "type": "http",
            "url": "https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp"
        }
    }
}
NPM package @niubai/pdfedit-mcp
Claude Code 
claude mcp add pdfedit-mcp -e 'PDFEDIT_API_KEY=<your pdfedit_api_key>' -e 'PDFEDIT_BASE_URL=http://localhost:8000' -- npx -y @niubai/pdfedit-mcp@0.1.10
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pdfedit-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@niubai/pdfedit-mcp@0.1.10"
            ],
            "env": {
                "PDFEDIT_API_KEY": "<your pdfedit_api_key>",
                "PDFEDIT_BASE_URL": "http://localhost:8000"
            }
        }
    }
}

Environment variables

  • PDFEDIT_API_KEY secret API 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_URL Gateway base URL. Defaults to http://localhost:8000; set it to the hosted API or to your own deployment.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

pdfedit-mcp

The agent-facing half of the PDF Edit API (https://api.niubai.vip): edit text inside PDFs that already exist -- replace, delete, redact, insert, fill forms -- keeping the original fonts and layout, with every change verified before it is returned.

Try it in 30 seconds, no key

The server works with no key at all: 20 pages a day per IP, outputs marked SAMPLE, local files included. Nothing to sign up for:

Claude Code

claude mcp add pdfedit -- npx -y @niubai/pdfedit-mcp

Cursor / VS Code / Claude Desktop — the buttons above, or this server entry:

{ "pdfedit": { "command": "npx", "args": ["-y", "@niubai/pdfedit-mcp"] } }

Then ask your agent: "In ./contract.pdf replace 'Acme Ltd' with 'Acme GmbH' and redact the IBAN." The edited PDF is written next to the original and a before/after picture of every change comes back. A free API key (200 pages a month, no watermark on ordinary documents) takes one email at https://api.niubai.vip; set it as PDFEDIT_API_KEY. Web clients that cannot run a local server (claude.ai) use the hosted endpoint https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp with PDF URLs.

No Node? Install the skill

The same API as an Agent Skill: a SKILL.md plus a stdlib-only Python script, for Claude Code, Codex, Cursor, Gemini CLI and any other agent that runs shell commands. Nothing to install but the skill itself:

npx skills add zp130221/pdfedit-mcp

Claude Code can also take the whole thing as a plugin, MCP server and skill together:

/plugin marketplace add zp130221/pdfedit-mcp
/plugin install pdfedit@pdfedit
WhatWhere
The whole API in one file, for an AI assistant (give it to a model and it knows how to call the API)api.niubai.vip/llms-full.txt
MCP server (npx -y @niubai/pdfedit-mcp) for Claude Code, Cursor, Claude Desktopmcp/pdfedit-mcp/
Agent skill (npx skills add zp130221/pdfedit-mcp), no Node neededskills/pdfedit/
TypeScript SDK (@niubai/pdfedit)sdk/typescript/
Python SDKsdk/python/
OpenAPI document the SDKs and tool schemas are generated fromopenapi/openapi.json
What it does, pricing, ten before/after examplesdocs/public/

Everything here is MIT. The editing engine behind the API is AGPL-3.0; the API serves its complete source to its users at GET /source (any API key, a free test key included).

The API is operated by Niubai (https://niubai.vip), support <zp130221@163.com>; payments are collected by Creem as merchant of record, so card details never reach the service and the cancel link is on the receipt. Terms, privacy and refunds: https://api.niubai.vip/legal. Documents are deleted within 24 hours and are never used for training.

Frequently asked questions

What is io.github.zp130221/pdfedit-mcp?

Edit text inside existing PDFs: replace, delete, redact, insert, fill forms; original fonts kept.

How do I install io.github.zp130221/pdfedit-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http pdfedit-mcp 'https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.zp130221/pdfedit-mcp need an API key?

Yes. It expects PDFEDIT_API_KEY, which you set in its configuration.

Is io.github.zp130221/pdfedit-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.zp130221/pdfedit-mcp?

It is published by zp130221. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.