Agent quick start

One SDK call or a transparent REST lifecycle

Start without an account, keep every write idempotent, and retrieve evidence-bearing records.

Fastest path: the SDK creates a restricted guest session automatically when no project key is configured.

JavaScript

import { readFile } from "node:fs/promises";
import { PDFCentralClient } from "https://pdf-central.com/sdk/javascript/index.mjs";

const pdf = new PDFCentralClient({ acquisitionChannel: "my-agent" });
const result = await pdf.readDocument(await readFile("input.pdf"), {
  allowOcr: true,
  maxCostMicrousd: 100000
});
console.log(result.records, result.receipt);

Python

from pdf_central import PDFCentralClient

pdf = PDFCentralClient(acquisition_channel="my-agent")
result = pdf.read_document("input.pdf", allow_ocr=True,
                           max_cost_microusd=100000)
print(result["records"], result["receipt"])

Download pdf_central.py, or use the machine-readable SDK manifest.

Remote MCP

{"mcpServers":{"pdf-central":{"url":"https://pdf-central.com/mcp/core"}}}

The core profile exposes exactly nine lifecycle and extraction tools. Switch to /mcp when the agent needs recipes, controlled import, batches, collections, comparison, classification, reviews, or the full live operation catalog.

REST lifecycle

  1. POST /api/v1/guest-sessions
  2. Create, upload, and complete a file, or use a controlled HTTPS import.
  3. Call POST /api/v1/process with a stable idempotency key and hard cost ceiling.
  4. Read the job until terminal.
  5. Retrieve artifact records, quality evidence, and the stable receipt.

Choose an integration