EN
Sign up

AI integrations · MCP server

Your AI assistant. Your data. A finished PDF.

Turn what’s already in your conversation into invoices, proposals and reports. Connect your assistant to ShipPDF to build reusable templates and generate documents with your branding.

Free plan. No credit card required.

Example conversationMCP
You

Create a reusable template from this scanned invoice. Then use it to invoice Acme for these three services.

ShipPDF

I’ll recreate the layout as a reusable template with fields for the customer and services. Then I’ll publish it and generate Acme’s invoice with the total calculated.

✓ create_template → publish_template → generate_document
InvoiceINV-1042

Customer Acme Co.

ServiceAmount
Product design$1,200.00
Development$2,400.00
Support$400.00
Total$4,000.00
PDF
acme-invoice-1042.pdfDocument generated

Illustrative preview

One endpoint for any MCP-compatible client

ClaudeChatGPTCodexSmithery.aiYour own agent

01 · Connect

From conversation to document

Add the remote server, authorize your workspace, and ask your assistant to use ShipPDF.

01

Create your account

Set up a workspace in ShipPDF. Your templates and documents become available to authorized connections.

02

Connect the MCP server

Add the endpoint to your client and authorize the connection with OAuth or an API token with the permissions you need.

03

Ask for your first PDF

Choose a published template and share your data. Your assistant generates the document and retrieves the PDF link.

Works with the assistant you already use

Connect the remote server with OAuth or an API token. Find the full walkthrough in the setup guide.

Claude Desktop

In Customize → Connectors, add a custom connector named ShipPDF. Paste the server URL and sign in to authorize your workspace.

https://mcp.shippdf.com

Enable the connector in your conversation and ask Claude to use ShipPDF.

Claude Code

Add ShipPDF from your terminal:

Terminal window
claude mcp add --transport http shippdf https://mcp.shippdf.com

Then run /mcp in Claude Code and sign in when prompted.

Full setup guide

ChatGPT · OAuth

Enable Developer mode in Settings → Security and login, if available. In Plugins, create a developer-mode app named ShipPDF with this URL and select OAuth.

https://mcp.shippdf.com

Complete ShipPDF sign-in, then select the app in your conversation’s Developer mode menu.

Test the connection

Ask your assistant to find a published template:

Use ShipPDF to list the published templates I can access.

Availability depends on your account and workspace policies.

Full setup guide

Codex · OAuth

Add the remote server and sign in from your terminal:

Terminal window
codex mcp add shippdf --url https://mcp.shippdf.com
codex mcp login shippdf

Use /mcp to inspect the connection.

Or use an API token

Add this to ~/.codex/config.toml:

[mcp_servers.shippdf]
url = "https://mcp.shippdf.com"
bearer_token_env_var = "SHIPPDF_API_TOKEN"

Set SHIPPDF_API_TOKEN in the environment that launches Codex. Create the token in ShipPDF’s Members & keys with the permissions you need.

Full setup guide

Remote MCP client

Add the server URL and choose OAuth, or configure an API token in the Authorization header.

https://mcp.shippdf.com

Granted permissions determine which templates and tools the client can use.

Clients that only support stdio

With Node.js installed, use mcp-remote as a local bridge. Add this configuration to your client:

{
  "mcpServers": {
    "shippdf": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.shippdf.com",
        "--header",
        "Authorization:${SHIPPDF_AUTH_HEADER}"
      ],
      "env": {
        "SHIPPDF_AUTH_HEADER": "Bearer spdf_xxx"
      }
    }
  }
}

Replace spdf_xxx with your API token and restart the client if required. Store the token in your client’s private configuration.

Full setup guide

Find ShipPDF on Smithery

Explore ShipPDF’s MCP server listing on Smithery for its tools and connection details.

ShipPDFView on Smithery
Open ShipPDF on Smithery

02 · Put it to work

More than a file generator

Create and edit templates

Describe your document’s structure. Your agent can create a draft, edit its fields and adjust its pages.

Find the right template

Browse available templates and their data schemas to fill each document with the right fields.

Generate the PDF

Use a published template and your data to generate a document and retrieve its download link.

Publish a reusable version

Turn your draft into a published revision. Use the same template from your agent or the REST API.

Control access

Workspace permissions and scoped tokens limit the tools and resources available to your agent.

Review before publishing

Inspect the template and generate previews before publishing a revision for your documents.

03 · Start with a request

The data is already there. Give it a document.

01

Invoices

“Use our invoice template for these services and give me the PDF link.”

02

Proposals

“Create a proposal template with our logo, the project scope and a pricing table.”

03

Reports

“Generate the inspection report with these findings and the published template.”

04

Labels

“Create a shipping label template with the recipient, address and a barcode.”

Before you connect

Which assistants work with ShipPDF?

Any MCP-compatible client that can connect to ShipPDF’s remote server. There are guides for Claude Desktop, ChatGPT and Codex, plus a bridge for clients that only support stdio.

Can my agent create a template from scratch?

Yes. MCP tools let your agent create and edit a draft, inspect the template, generate previews, and publish a reusable revision.

Do I need to write code?

You can connect a compatible assistant and ask it to create templates or generate documents in natural language. Initial setup depends on the client you use.

Do AI-generated PDFs use different credits?

No. PDF generation through MCP uses the same published templates and workspace credits as the REST API.

Can I limit what my agent can do?

Yes. Available tools depend on granted scopes. An API token can also restrict access to specific resources; OAuth connections have workspace-wide resource access within their granted scopes.

Ready to connect

Your next conversation can end with a PDF.

Create your account, connect your assistant, and generate your first document with ShipPDF.