docsapi_key

PDF Blocks

PDF Blocks provides synchronous API operations for merging, splitting, watermarking, securing, and reorganizing PDF documents.

Verdict

PDF Blocks exposes 17 PDF manipulation tools your team can invoke by @mentioning it in a Project. Add watermarks, merge files, extract or remove pages, encrypt with passwords, set granular permissions, and strip encryption—all without leaving the conversation. Most valuable for teams that handle contracts, proposals, or client deliverables and need quick edits without opening desktop software. Requires an API key from PDF Blocks; each operation consumes credits from your account, so watch usage on high-volume workflows.

Common use cases

  • Watermark draft proposals before client review
  • Merge signed contracts into one archive file
  • Extract specific pages from lengthy reports
  • Password-protect NDAs before external sharing
  • Strip passwords from internal policy documents

Integration

Vendor
PDF Blocks
Category
docs
Auth
API_KEY
Tools
17
Composio slug
pdf_blocks

Tools

  • Add Image Watermark

    Add a PNG or JPEG image as a watermark on all or selected PDF pages.

  • Add PDF Password

    Create an encrypted copy of a PDF that requires a password to open.

  • Add PDF Restrictions

    Create an encrypted PDF copy with explicit permissions for copying, editing, printing, forms, assembly, and accessibility. Permissions are allowed by default; set an allow_* parameter to false to restrict that capability.

  • Add Text Watermark

    Add up to three styled text lines as a watermark on all or selected PDF pages.

  • Extract PDF Pages

    Create a PDF containing selected source pages in their original order.

  • Merge PDFs

    Merge PDF files into one PDF in the exact order provided.

  • Remove PDF Pages
    destructive

    Create a PDF with selected pages removed while preserving the remaining page order.

  • Remove PDF Password
    destructive

    Create an unencrypted copy of a password-protected PDF using its current password.

  • Remove PDF Restrictions
    destructive

    Create a PDF copy with permission restrictions cleared.

  • Remove PDF Signatures
    destructive

    Create a PDF copy with all digital signatures and timestamps removed.

  • Reorder PDF Pages

    Create a PDF in an exact page order, optionally dropping or repeating source pages.

  • Reverse PDF Pages

    Create a PDF with the complete page order reversed.

  • Rotate PDF Pages

    Rotate all or selected PDF pages by a supported multiple of 90 degrees.

  • Split PDF at Page

    Split a PDF into exactly two downloadable PDFs at a page boundary; the selected page starts the second PDF.

  • Split PDF by Page Count

    Split a PDF into consecutive downloadable PDFs containing up to a fixed number of pages each.

  • Split PDF by Page Groups

    Create one downloadable PDF for each caller-defined ordered group of source pages.

  • Split PDF by Size

    Split a PDF into downloadable PDFs no larger than a requested byte limit.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations. 2. Find PDF Blocks in the MCP directory and click Connect. 3. Visit the PDF Blocks dashboard, generate an API key under Account > API Keys, and copy it. 4. Paste the key into Switchy's connection dialog and click Authorize. 5. Switchy confirms the connection and shows the 17 available tools. 6. Inside any Project, type '@PDF Blocks merge these three proposals into one file' and attach the PDFs—the MCP executes the merge and returns a download link. 7. Test the connection by asking '@PDF Blocks add a text watermark saying DRAFT to this contract' with a sample PDF attached. 8. If the operation fails, check your PDF Blocks credit balance and confirm the API key has not expired.

What teammates see: by default, memories from PDF Blocks 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

Watermark Draft Proposal

@PDF Blocks add a text watermark that says 'DRAFT' in gray, centered on every page of this proposal PDF.

Merge Contract Bundle

@PDF Blocks merge these three signed contracts into one PDF in the order I've attached them.

Extract Executive Summary

@PDF Blocks extract pages 1 through 5 from this quarterly report and create a new PDF.

Password-Protect NDA

@PDF Blocks add password protection to this NDA using the password 'SecureNDA2025'.

Remove Page from Invoice

@PDF Blocks remove page 3 from this invoice PDF and give me the updated file.

Example outputs

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

Prompt

@pdfblocks merge the three contract drafts in our /legal folder into a single PDF, ordered by date

Output

I've merged contract_draft_v1.pdf, contract_draft_v2.pdf, and contract_draft_v3.pdf into a single document. The combined PDF is 47 pages and preserves all original formatting. The merge operation completed successfully and the file is now available at the URL provided by PDF Blocks. This example shows how the MCP handles multi-file operations — in practice, you'd receive a download link or reference to the merged output.

Notes

This example demonstrates the merge tool, which is useful for consolidating related documents before review or distribution. The MCP requires valid API credentials and processes files synchronously, so larger PDFs may take several seconds. You'll need to handle the output URL or file reference in your workflow.

Prompt

@pdfblocks add password protection to final_proposal.pdf using 'SecurePass2024' and restrict printing and editing

Output

I've created an encrypted copy of final_proposal.pdf with the password you specified. The new PDF requires 'SecurePass2024' to open and has printing disabled and editing disabled per your request. Copying text and accessibility features remain enabled by default. The protected file is ready for distribution. This illustrative response shows how the MCP confirms both password application and permission restrictions in one operation.

Notes

This showcases the security tools — password protection and permission restrictions work together to control document access. Be aware that PDF encryption is not unbreakable, and you must communicate the password through a separate secure channel. The MCP creates a new file rather than modifying the original in place.

Prompt

@pdfblocks extract pages 5-12 from the Q4_report.pdf and summarize the financial tables on those pages

Output

I've extracted pages 5-12 from Q4_report.pdf into a new 8-page document. Reviewing the extracted content, I found three financial tables: a revenue breakdown by region showing 34% growth in APAC, an expense summary indicating a 12% reduction in operational costs, and a cash flow statement with $2.1M positive net cash from operations. The extraction preserved all table formatting and footnotes. This example pairs the MCP's page extraction with AI analysis of the resulting content.

Notes

This demonstrates how extraction enables focused analysis — the MCP pulls specific pages, then the AI can reason over that subset. Useful when working with large reports where you only need a section. The MCP doesn't parse table data itself; the AI interprets the extracted PDF content, so accuracy depends on how cleanly the tables render in the extraction.

Use-case deep-dives

Client deliverable watermarking workflow

When PDF Blocks beats manual watermarking for agencies

A 6-person design agency ships 40-60 client mockups per month as PDFs. Before final payment, every file needs a draft watermark; after payment, the watermark comes off and the file gets password-protected. PDF Blocks handles this in Switchy with two tools (Add Text Watermark, Add PDF Password) instead of opening Acrobat 60 times. The auth is a single API key shared across the team workspace. This works until you hit ~200 PDFs/month or need custom watermark positioning—at that scale, you want a dedicated asset pipeline. For typical agency volume, PDF Blocks turns a 90-minute monthly chore into a 10-minute batch operation.

Contract redaction for HR teams

PDF Blocks for removing sensitive pages before handoff

A 3-person HR team at a 50-employee startup needs to share employment agreements with finance, but pages 4-6 contain salary bands that can't leave HR. The Remove PDF Pages tool lets them strip those pages in Switchy without emailing the full doc to themselves, downloading, editing in Preview, re-uploading. The limitation: if you need to redact text within a page (not remove the whole page), PDF Blocks can't do it—you need a redaction-specific tool. For page-level removals before internal handoffs, this MCP saves 5-10 minutes per contract and keeps the original file out of uncontrolled inboxes. If your team processes more than 15 contracts a week, set up a shared Switchy workflow so the same Remove Pages prompt works every time.

Proposal assembly from template library

When Merge PDFs replaces copy-paste proposal building

A 4-person sales team maintains 12 PDF modules (intro, pricing tiers, case studies, terms) and assembles custom proposals by combining 4-6 modules per deal. PDF Blocks' Merge PDFs tool lets them list the modules in Switchy and get a single proposal PDF in 30 seconds. The alternative—opening each PDF, copying pages into a new doc—takes 8-12 minutes and introduces page-order mistakes. This works cleanly until your module library exceeds 30 files or you need conditional content (if enterprise tier, include module X). At that threshold, a proposal automation platform makes more sense. For small teams with a stable module set and 10-20 proposals a month, PDF Blocks in Switchy turns proposal assembly into a one-prompt task.

Frequently asked

What does the PDF Blocks MCP let me do in Switchy?

It gives your AI agents direct access to PDF manipulation tools — merging files, extracting or removing pages, adding watermarks, setting passwords, and controlling print/copy permissions. Your team can automate document workflows without switching to a separate PDF editor or writing custom scripts.

Do I need a PDF Blocks API key to use this MCP?

Yes. The MCP authenticates via API key, so you'll need an active PDF Blocks account. Grab your key from the PDF Blocks dashboard, paste it into Switchy's connection settings, and the MCP handles the rest. No OAuth dance required.

Can the PDF Blocks MCP edit text inside an existing PDF?

No. It can add watermarks, merge files, extract or remove pages, and set encryption — but it won't rewrite paragraph text or reflow layouts. If you need to edit the actual content of a PDF, you'll still need a dedicated editor like Adobe Acrobat.

Why use this MCP instead of calling the PDF Blocks API directly?

The MCP wraps the API so your AI agents can call PDF operations in natural language without you writing integration code. You describe what you want — "merge these three contracts and password-protect the result" — and the agent picks the right tools and parameters.

Who on my team should connect the PDF Blocks MCP?

Whoever owns your PDF Blocks subscription and has the API key. Once connected in Switchy, any team member can invoke the tools through shared agents — they don't each need their own PDF Blocks account or key.

More docs MCPs

See all docs MCPs →

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