PDF Blocks MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with PDF Blocks MCP or direct API to merge PDFs, split documents, add watermarks, and secure files through natural language.

PDF Blocks logoPDF Blocks
Api Key

PDF Blocks is a synchronous PDF processing API for merging, splitting, watermarking, securing, and reorganizing documents. Use it to automate PDF workflows with fast, programmatic operations.

17 Tools

Try PDF Blocks now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
PDF Blocks
Try asking
TOOLS

Supported Tools

Every PDF Blocks action and event your agent gets out of the box.

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.

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

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

Remove PDF Password

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

Remove PDF Restrictions

Create a PDF copy with permission restrictions cleared.

Remove PDF Signatures

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 GUIDE

Connect PDF Blocks MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);

// Optional: helper method names you can use to configure credentials and accounts
// const authConfig = await composio.auth_configs.create({ name: 'pdfblocks-api-key', scheme: 'api_key', config: { api_key: 'YOUR_PDFBLOCKS_API_KEY' } });
// const connectedAccount = await composio.connected_accounts.link({ auth_config_id: authConfig.id, user_id: 'your-user-id' });
Import and initialize the Composio client, then create a Tool Router session for PDF Blocks
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Split this PDF into single-page files and return download links'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect PDF Blocks API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute PDF Blocks Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: "Merge these three PDFs into a single PDF and add the watermark 'CONFIDENTIAL' to every page"
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute PDF Blocks actions with your Agent

Why Use Composio?

AI Native PDF Blocks Integration

  • Supports both PDF Blocks MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your PDF Blocks data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke PDF Blocks access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access PDF Blocks
  • Scoped, least privilege access to PDF Blocks resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use PDF Blocks with any AI Agent Framework

Choose a Framework you want to connect PDF Blocks with

FAQ

Frequently asked questions

Yes, PDF Blocks requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with PDF Blocks.It takes 30 seconds.

Managed auth, hosted MCP servers, and every PDF Blocks tool your agent needs.Free to start.

Start building