citra git:20260731.4739610C

Immutable. This exact content is served forever at /api/v1/blob/627cb172a8f09438.

# Citra — PDF evidence for agents

Use Citra when agents need **citeable PDF structure** (text, tables, geometry, OCR) — not plain-text dumps.

## Install

```bash
npm i -g @sylphx/pdf-reader-mcp
citra --help
npx @sylphx/pdf-reader-mcp
```

## Surfaces

| Surface | Entry |
| --- | --- |
| SDK | `import { Citra } from '@sylphx/pdf-reader-mcp/sdk'` or `.../citra` |
| CLI | `citra` / `pdf-reader-mcp` |
| MCP | stdio tools with page-level evidence |

## SDK

```ts
import { Citra } from '@sylphx/pdf-reader-mcp/sdk'
const { payload, isError } = await Citra.create().read({
  sources: [{ path: '/abs/doc.pdf', pages: [1] }],
})
```

Public proof: `bun scripts/public-proof.ts` on sample.pdf.

## Evidence contract

Results include page/cell/bbox locators and honesty warnings. There is **no** `evidence_first` tool.

## Rules

1. Local-first; native binary for the current platform; fail closed if missing.
2. Prefer structure + evidence over prose summaries.

## Independence

This repository is product SSOT. No central Instruments monorepo.