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
POST /api/v1/guest-sessions- Create, upload, and complete a file, or use a controlled HTTPS import.
- Call
POST /api/v1/processwith a stable idempotency key and hard cost ceiling. - Read the job until terminal.
- Retrieve artifact records, quality evidence, and the stable receipt.