Paperful Icon
Paperful
Program

Your documents.
Your building blocks.

Turn documents into structured, developer-friendly objects. Build applications, workflows, and AI agents with a single API.

Free to start. No credit card required.

One API, every primitive

Upload, organize, read and search your documents, from the same small set of calls.

  • Papers
  • Graph
  • Search
  • Usage
SDK
const paper = await paperful.papers.upload({
file,
fileName: "report.pdf",
});
ResponsePOST/v1/papers
{
id: "a3f2…9c1e",
fileName: "report.pdf",
status: "ready",
pages: 12,
}

Every SDK call maps to one REST endpoint. Use whichever fits your stack.

Three ways in

Typed SDKs for your code, a REST API for any language, and MCP for AI assistants and agents.

SDK

Typed calls for JavaScript and TypeScript, on Node.js, Bun and serverless.

$ npm install @paperful/sdk
import { Paperful } from
"@paperful/sdk";
const paperful = new Paperful();
// reads PAPERFUL_API_KEY

REST API

The same API from any language, with an API key and plain HTTP.

curl \
https://api.paperful.io/v1/papers \
-H "Authorization: Bearer pf_…"
# →
{
total: 24,
cursor: { next: "eyJ…" },
items: [...]
}

MCP

For AI assistants and agents. Add the server, sign in, and ask away.

Server URLhttps://mcp.paperful.ioSign in with OAuth, no API key
  • Claude
  • ChatGPT
  • Claude Code
  • Codex
  • Cursor
  • VS Code
CLAUDE.md
## Documents
Specs are in Paperful. Use the search tool before implementing.

Built for developers

Typed responses, clear errors, streaming and pagination, so you write less glue code.

Typed

Every response is typed, and checking a node's type narrows its data.

if (node.is("table")) {
node.data?.summary
  • summarystring
  • rowsnumber
  • columnsnumber
  • cellsNodeTableCell[]
  • insightsNodeInsight[]
  • importanceNodeImportance

Errors

A class for every error, with its status and whether to retry.

catch (error) {
if (error instanceof
Unauthorized)
status: 401name: "unauthorized"retry: false

Streaming

Follow an upload as it's processed, or a search as it runs, event by event.

onEvent: ({ event, data }) => { … }
// papers.upload
  • "started" {}
// search.query

    Pagination

    Lists come a page at a time, with a cursor to the next one.

    const more = await paperful.papers.list({ next: cursor.next });
    items: 10 of 24cursor.next: "eyJ…1"

    Enterprise Ready

    Secure, compliant and built for scale.

    Reliable & Scalable

    Process one document or millions with the same API.

    Your Data, Your Control

    Your data stay yours. We never train on it.

    Built for Developers

    Simple APIs, SDKs and tools to build faster.

    Frequently Asked Questions

    Build on your documents