Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

Doxtract

✓ manoonlabs.com

de manoonlabsversión 1.2.0i★ 0iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registrocom.manoonlabs/doxtract

Cómo instalar

Qué hace

Invoices, receipts and statements into clean rows you can check and export. REST API and MCP.

Texto original del autor

  • Conexión Se ejecuta en la nube
  • Cuenta o clave Necesita Authorization
  • Categoría Contabilidad, finanzas e impuestos

Por qué está en este puesto

Está en la pestaña “Apps que se conectan a la IA”, que se ordena sin estrellas, en este orden

1. En el directorio de conectores de ClaudeNo
2. Probado por nuestro equipoNo
3. Útil para usuarios de TailandiaNo
4. Uso sin estrellas20/100Popularidad 0 · Actualidad 12 · Sigue respondiendo 8 · Me gusta de usuarios +0
5. Registrado el2026-11-20

Me gusta de usuarios: 0 · Suma como máximo 5 puntos (1 por persona). No se puede comprar.

Calidad: Pasó 4/4 revisiones básicas (se muestra, no ordena)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Doxtract. Sigue https://mcp.popnx.com/i/manoonlabs-doxtract.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/4 revisiones · Lo que preguntas pasa por el servidor del autor (doxtract.manoonlabs.com) · ✓ Comandos revisados el 21 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 5 min

Necesitas una clave de Doxtract (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Regístrate y crea una clave de Doxtract

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Doxtract ↗

  2. Pulsa este botón: Claude abre la ventana para añadir el conector ya rellenada

    Añadir Doxtract a Claude ↗

    El nombre y la URL ya están puestos. Revísalos y pulsa Add · si no has iniciado sesión, Claude te lo pedirá primero

    En Request headers, añade este nombre y valor

    Nombre del headerAuthorization
    ValorBearer <pega tu clave aquí>

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

    ¿El botón no funciona? Rellénalo tú

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4

    Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreDoxtract
    Remote MCP server URL · Direcciónhttps://doxtract.manoonlabs.com/mcp
  3. Actívalo en un chat

    +ConnectorsDoxtract

  4. Pruébalo

    Usa Doxtract y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Doxtract o muestra una herramienta de Doxtract en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Doxtract

Doxtract necesita tu propia clave para conectarse, pero la ayuda de OpenAI solo describe el inicio de sesión con OAuth; no hay una opción de clave que hayamos podido verificar

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Doxtract

  • Necesitas una clave de Doxtract (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
  • Necesitas una clave de Doxtract (créala en el sitio del autor)
  • Necesitas una clave de Doxtract (créala en el sitio del autor)
  • Necesitas una clave de Doxtract (créala en el sitio del autor)

B · Otros en Contabilidad, finanzas e impuestos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code · unos 5 min

Necesitas una clave de Doxtract (créala en el sitio del autor)

  1. Regístrate y crea una clave de Doxtract

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Doxtract ↗

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user doxtract https://doxtract.manoonlabs.com/mcp --header 'Authorization: Bearer your-value'

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Escribe /mcp en Claude Code

    Deberías ver Doxtract en la lista como conectado

  5. Pruébalo

    Usa Doxtract y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Doxtract o muestra una herramienta de Doxtract en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 5 min

Necesitas una clave de Doxtract (créala en el sitio del autor)

  1. Regístrate y crea una clave de Doxtract

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Doxtract ↗

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Doxtract, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de Cursor en modo Agent

  5. Pruébalo

    Usa Doxtract y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Doxtract o muestra una herramienta de Doxtract en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 5 min

Necesitas una clave de Doxtract (créala en el sitio del autor)

  1. Regístrate y crea una clave de Doxtract

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Doxtract ↗

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Doxtract, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de VS Code en modo Agent

  5. Pruébalo

    Usa Doxtract y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Doxtract o muestra una herramienta de Doxtract en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://doxtract.manoonlabs.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Doxtract💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user doxtract https://doxtract.manoonlabs.com/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "doxtract": {
      "url": "https://doxtract.manoonlabs.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "doxtract": {
      "type": "http",
      "url": "https://doxtract.manoonlabs.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Valores que debes completar

  • Authorization secreto obligatorio HTTP header
    Token Bearer. Obtenga una clave mldxt_ en API Keys de la consola de Doxtract.
    Ver original en inglésBearer token. Get a mldxt_ key from API Keys in the Doxtract console.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Dominio verificado
✓ manoonlabs.com
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
1.2.0
Publicado en el registroi
21 nov 2026
Último cambio de códigoi
21 nov 2026
Última revisión
21 nov 2026
Creador
manoonlabs
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 21 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • whoami

    Return the workspace and token for the bearer credential, and the credits left this month.

  • parse_document

    Extract structured fields from a PDF, PNG, JPEG, or text file sent as base64 in file_base64, or from plain text sent in text (10 MB and 10 pages on Free, 25 MB on Starter and Pro, 100 MB on Business; pages per document by plan: Starter 50, Pro 200, Business 500). 1 credit per pag

  • list_schemas

    List the extraction layouts saved in this workspace.

  • get_schema

    Read one saved extraction layout by slug.

  • create_schema

    Save an extraction layout in this workspace. The slug (API id) is derived from the display name. A layout is {"type":"object","properties":{...}}. Each property is {"type":T} where T is one of any, null, boolean, string, number, date, array, object. An optional description, at mo

  • update_schema

    Update a saved layout's display name and/or definition. A layout is {"type":"object","properties":{...}}. Each property is {"type":T} where T is one of any, null, boolean, string, number, date, array, object. An optional description, at most 400 characters, tells the model how to

  • list_inboxes

    List the inboxes this key can see, newest first, up to 200. Each has its id, name, icon, status, document count and email address. A key limited to some inboxes sees only those.

  • get_inbox

    Read one inbox: its name, icon, status, document count, email address, and its fields as a JSON schema (schema, null for a draft with no fields yet). The fields show what kind of document the inbox reads, so use them to decide which inbox a document belongs in.

  • upload_document

    Add one document to an inbox. It is read with the inbox's fields in the background, the same as a document dropped into the inbox in the console, and costs 1 credit per page. Send the file as file_base64 (a PDF, PNG or JPEG) with its file_name. Returns the new document's id. Uplo

  • create_inbox

    Create an inbox in this workspace and return its id and email address. Send template (a built-in template slug: invoice, receipt, bank_statement, purchase_order) to make it ACTIVE with that template's fields, the same as creating one in the console. Without a template it is a DRA

  • create_inbox_from_schema

    Create an active inbox from a schema you send, in the same format as a saved layout. The inbox gets its own fields, its email address is returned, and mail and uploads are parsed at once. This path is for the API and MCP only; the console does not offer it.

  • update_inbox

    Change an inbox's name and/or icon. Send name, icon, or both. Send icon as null to go back to the default icon. Renaming does not change the email address.

  • get_inbox_email

    Read an inbox's email address and whether it accepts mail. The address is created the first time it is read.

  • set_inbox_email_enabled

    Turn mail receiving on or off for one inbox. The address does not change. Documents already in the inbox are not affected.

  • set_inbox_webhook

    Save where an inbox sends each parsed document, so documents that arrive by email or upload reach your system without a poll. Each body is signed with the returned secret. An empty url turns the webhook off. Only a key created by the workspace owner can change it.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 21 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con el dominio manoonlabs.com (el registro comprueba quién es dueño del dominio)

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hoy

  • – No aplica

    Tiene licencia

    No aplica: servidor en la nube del propio dueño de manoonlabs.com; no ejecutas código del repo

  • ✓ Superada

    El endpoint responde

    Respondió en 335 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 15 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/manoonlabs-doxtract.svg)](https://mcp.popnx.com/en/servers/manoonlabs-doxtract)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Contabilidad, finanzas e impuestosi

  • Más estrellas que el 0% de los otros 3609 servidores de esta categoría
  • Publicado en el registro más recientemente que el 95% de los otros 3609 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 3609 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Doxtract?

Superó 4 de 4 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: Authorization

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hoy, y la última versión (1.2.0) llegó al registro hoy.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

de SolidInvoiceEn crecimiento★ 989Actualizado hace 12 días

Se ejecuta en la nube✓ del servicio · solidinvoice.co

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

de CursivezEn crecimiento★ 265Actualizado hace 13 días

Se ejecuta en la nube✓ del servicio · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

de bex-coEn crecimiento★ 723 Estrellas de todo el repositorioActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

de twelvedataEn crecimiento★ 87Actualizado hace 17 días

Se ejecuta en la nube✓ del servicio · twelvedata.com
Comparado con otros parecidos
Este
Doxtract
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoSíNo
Se añade con + en ClaudeNoNoNoNoNoSí
Revisiones básicas4/44/64/44/45/54/4
LicenciaMITMITNOASSERTIONMITMIT–
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Get an API key · API docs · Playground · MCP server · Benchmark

The official JavaScript and TypeScript SDK for Doxtract. Send a PDF, scan, phone photo or text, plus the schema you want. Get back JSON in that shape. If a field isn't on the document, you get null, not a guess.

import { Doxtract } from "@manoonlabs/doxtract";

import { z } from "zod";

const doxtract = new Doxtract(); // reads DOXTRACT_API_KEY

const Invoice = z.object({ vendor: z.string().nullable(), total: z.number().nullable() });

const { values } = await doxtract.parse("invoice.pdf", { schema: Invoice }); values.total; // number | null

Contents

  • Why Doxtract
  • Benchmark
  • Citations
  • Install
  • Quick start
  • Inputs
  • Schemas
  • Excel and CSV export
  • Checking your key
  • Async jobs
  • Error handling
  • Retries, timeouts and cancellation
  • Options
  • Runtime support
  • MCP and the web app
  • Pricing
  • Development
  • License

Why Doxtract

  • It copes with messy input. Rotated pages, phone photos, scanned receipts and multi-page PDFs. That's where a plain LLM prompt starts guessing.
  • The schema drives the output. You define the fields once, as a saved schema or inline. Every response matches that shape, and arrays are always arrays.
  • Typed end to end. Pass a Zod schema and values is typed from it, or use parse () for values: T. Errors come back as classes you can instanceof.
  • Zero runtime dependencies. The only package it asks for is zod as a peer, for Zod schemas. It's built on native fetch and FormData, ships as ESM and CommonJS, and runs server-side on Node 18+, Bun and Deno.
  • One API in three places. Use it over REST (this SDK), as an MCP server for AI agents and editors, or in the web app.

Benchmark

We ran Doxtract and a plain LLM prompt over 45 public documents with the same schema, then scored every field against a hand-checked answer key.

Fields extracted correctlyDoxtractPlain LLM prompt
All fields98.7%69.7%
Rotated pages100%39.3%
Phone photos96.2%56.4%
Made-up values per 100 fields (all 50 docs)0.11.9

The method, caveats and per-document CSV are on the benchmark page.

Citations

Every extracted value links back to where it came from. Click a value to see its box on the document, or click a box to jump to the value.

In the SDK, set citations: true:

const result = await doxtract.parse("invoice.pdf", { schema: Invoice, citations: true });

result.citations?.["total"]; // { page: 1, text: "Total 1,280.50", bbox: [0.62, 0.81, 0.91, 0.84], status: "verified", source: "text_layer" }

  • Keys: one per value path, such as total or lineItems[0].amount.
  • `page` and `text`: the 1-based page and the printed text the value was read from. page is null for a text document.
  • `bbox`: [x0, y0, x1, y1] as fractions of the page from the top left, or null when there's no box.
  • `status`: verified, fuzzy, mismatch, other_page or unverified, from checking the text against the page.

Install

npm install @manoonlabs/doxtract

or

pnpm add @manoonlabs/doxtract yarn add @manoonlabs/doxtract bun add @manoonlabs/doxtract

On Deno, import npm:@manoonlabs/doxtract.

zod (version 4) is a peer dependency, used only when you pass a Zod schema. npm 7 and later and pnpm install it for you. On Yarn, run yarn add zod if you want Zod schemas. Plain schemas work without it.

Quick start

  1. Sign up and create a key on the API Keys page. The full secret is shown once.
  2. Put the key in your environment:
   export DOXTRACT_API_KEY=bk_live_...
  1. Parse a document:
   import { Doxtract } from "@manoonlabs/doxtract";

import { z } from "zod";

const doxtract = new Doxtract({ apiKey: process.env.DOXTRACT_API_KEY });

const Invoice = z.object({ vendor: z.string().nullable(), total: z.number().nullable(), });

const result = await doxtract.parse("invoice.pdf", { schema: Invoice });

console.log(result.values); // { vendor: "Northwind Supply", total: 1280.5 }

Not using Zod? Pass a plain JSON schema or a saved schema name instead. See Without Zod.

If you leave out apiKey, the client reads DOXTRACT_API_KEY, then DOC2JSON_API_KEY. If there's no key at all, the constructor throws a DoxtractError with code missing_api_key. Doc2Json and Doc2JsonError are still exported.

Want to see the output before writing code? Run a sample invoice in the Playground. No sign-in needed.

Inputs

parse() takes the document in whatever form you have it:

import { readFile } from "node:fs/promises";

// A file path (Node, Bun and Deno) await doxtract.parse("./invoice.pdf");

// Bytes: Buffer, Uint8Array or ArrayBuffer await doxtract.parse(await readFile("invoice.pdf"), { filename: "invoice.pdf" });

// A Blob or File, for example from an await doxtract.parse(input.files[0]);

// Base64 (a data: URL prefix is removed for you) await doxtract.parse({ base64: pdfBase64, filename: "invoice.pdf" });

// Plain text, such as an invoice email await doxtract.parse({ text: "Invoice INV-1042 from Northwind Supply. Total 1280.50 USD." });

  • Formats: PDF, PNG, JPEG and UTF-8 text files work. The type is read from the file bytes, not the name.
  • Limits: on the Free plan, documents can be up to 10 MB and 10 pages. Paid plans allow 25 MB and 50 pages. A document over the page limit is refused before any credit is spent.
  • Filename: this sets the document name used in your activity log and in export file names. It defaults to the file's own name.

Schemas

Without a schema, Doxtract chooses the fields. To control the output, pass a Zod schema, a plain JSON schema, or the name of a schema saved in your workspace.

Zod schemas

Pass a Zod 4 schema and values is typed with z.infer. There's no JSON to write and no generic to add. The SDK converts the schema for you:

import { z } from "zod";

const Invoice = z.object({ vendor: z.string().nullable(), total: z.number().nullable(), issued: z.iso.date().nullable(), // yyyy-mm-dd lineItems: z.array(z.object({ description: z.string(), amount: z.number() })), });

const result = await doxtract.parse("invoice.pdf", { schema: Invoice });

result.values.total; // number | null result.validation.success; // true when values match Invoice

  • Use `.nullable()` on any field that might not be on the document. Doxtract returns null for a missing value, and .nullable() keeps your types honest.
  • Hints: .describe("...") tells Doxtract how to read a field.
  • Arrays: an array field is always an array, and [] when there are no rows.
  • Validation: the result also has validation, which is schema.safeParse(values). A mismatch never throws. Check validation.success, and read validation.error.issues for the details. values is always the JSON the API sent, so read validation.data if your schema uses transforms or z.coerce.
  • Install: zod is a peer dependency. npm 7 and later install it with the SDK, so there's usually nothing to do.
  • Mapping: z.string(), z.number() (and .int()), z.boolean() and z.object() map to the same Doxtract types. z.iso.date() becomes date, sent back as a yyyy-mm-dd string. An enum becomes a string with the allowed values added to the hint, and a literal becomes its own type. .optional() drops the key from required. Shapes with no Doxtract type, such as a union of two types, z.record() or z.unknown(), become any. Checks like .min() or .regex() aren't sent, but validation still applies them.
  • Dates as `Date`: z.date() also becomes date, but the API still sends a string. Use z.coerce.date() and read validation.data to get a Date.
  • See the result: zodToSchema(Invoice) returns the definition the SDK sends.
  • zod/mini schemas work too. Zod 3 schemas don't, so upgrade to zod@4.
Without Zod

Pass the definition as a plain JSON schema object, and add the type yourself with parse ():

type Invoice = {

vendor: string | null; total: number | null; issued: string | null; // yyyy-mm-dd lineItems: { description: string; amount: number }[]; };

const result = await doxtract.parse ("invoice.pdf", { schema: { type: "object", properties: { vendor: { type: "string" }, total: { type: "number" }, issued: { type: "date" }, lineItems: { type: "array", items: { type: "object", properties: { description: { type: "string" }, amount: { type: "number" }, }, required: ["description", "amount"], }, }, }, required: ["vendor", "total"], }, });

result.values.total; // number | null

  • Field types: string, number, boolean, date, array, object, null and any.
  • Dates: a date comes back as yyyy-mm-dd.
  • Hints: add a description to any field to tell Doxtract how to read it.
  • Missing values: a value that isn't on the document is null.
  • Arrays: an array field is always an array, and [] when there are no rows.
  • No setup: plain schemas work without zod installed.
Saved schemas

Save a schema once and refer to it by name from every app, key and MCP client in the

Solo se muestra el principio; lee el resto en el repo