# Parseur — how to use (mcp.ai)

Connect your Parseur account and use 26 tools for document data extraction straight from your AI agent. Connect with your own API key. Parseur is an AI-powered data extraction tool that automates the parsing of emails, PDFs, and other documents into structured data.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_parseur?ms=1787293680000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `parseur_copy_document`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/parseur`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/parseur/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/parseur/copy/document` — Tool to copy a document to another mailbox. Use when you need to duplicate a document from one mailbox to another mailbox within Parseur.
  - body: { id: string, target_mailbox_id: string }
- `POST https://api.mcp.ai/api/parseur/copy/mailbox` — Tool to copy a mailbox (parser) in Parseur. Creates a duplicate of the mailbox with all its configuration. Use when you need to duplicate an existing parser setup.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/parseur/create/custom/download` — Tool to create a custom download (export configuration) for a mailbox. Use when you need to define which fields should be exported to CSV or XLS format.
  - body: { id: integer, name: string, type?: string, items: string[], parser_id: string, csv_download: string, xls_download: string, parser_field_id?: string, parser_field_name?: string }
- `POST https://api.mcp.ai/api/parseur/create/mailbox` — Tool to create a new mailbox (parser) in Parseur. Use when you need to set up a new parser for document parsing with custom configuration.
  - body: { name?: string, ai_engine?: string, force_ocr?: boolean, ai_instructions?: string, retention_policy?: integer, allowed_extensions?: string[], master_parser_slug?: string, process_attachments?: boolean, identification_status?: string }
- `POST https://api.mcp.ai/api/parseur/delete/custom/download` — Tool to delete a custom download (export configuration) from a mailbox. Use when permanently removing an export configuration after confirming its ID.
  - body: { id: string, mailbox_id: string }
- `POST https://api.mcp.ai/api/parseur/delete/document` — Tool to delete a specific document by ID. Use when permanently removing a document after confirming its ID.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/parseur/delete/mailbox` — Tool to delete a mailbox (parser) by ID. Use when permanently removing a mailbox after confirming its ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/parseur/delete/webhook` — Tool to delete a specific webhook. Use when permanently removing a webhook after confirming its ID.
  - body: { webhook_id: integer }
- `POST https://api.mcp.ai/api/parseur/disable/webhook` — Tool to disable a webhook for a mailbox. Removes the webhook association from the specified mailbox. Use when you need to stop an active webhook from sending parsed data.
  - body: { mailbox_id: integer, webhook_id: integer }
- `POST https://api.mcp.ai/api/parseur/enable/webhook` — Enables a paused webhook for a specified mailbox, allowing it to receive and forward parsed document events. Use this action to re-enable a webhook that was previously paused. Only webhooks listed in 
  - body: { mailbox_id: integer, webhook_id: integer }
- `POST https://api.mcp.ai/api/parseur/get/bootstrap/config` — Tool to retrieve bootstrap configuration data. Use when you need system-wide configuration choices, field format mappings, maximum field lengths, or master parser definitions.
- `POST https://api.mcp.ai/api/parseur/get/document` — Tool to retrieve full details of a specific document by ID. Returns document status, processing info, parsed results, and download URLs for JSON, CSV, and XLS formats.
  - body: { id: string }
- `POST https://api.mcp.ai/api/parseur/get/document/logs` — Tool to get document logs for a specific document. Returns paginated list of logs with status, source, and message details. Use when you need to troubleshoot or audit document processing history.
  - body: { id: string, page?: integer, search?: string, ordering?: string, page_size?: integer }
- `POST https://api.mcp.ai/api/parseur/get/mailbox` — Tool to retrieve full mailbox (parser) configuration by ID. Use when you need complete details about a specific mailbox including fields, webhooks, and settings.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/parseur/get/mailbox/schema` — Tool to retrieve the JSON schema for a mailbox's parsed fields. Use when you need to understand the structure and types of data fields extracted by a specific parser.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/parseur/list/custom/downloads` — Tool to retrieve custom downloads (export configurations) for a mailbox. Use when you need to list available export formats and their download URLs.
  - body: { id: string }
- `POST https://api.mcp.ai/api/parseur/list/documents/in/mailbox` — Tool to list documents within a specific mailbox. Use when you need to paginate, search, or sort the documents of a given mailbox after obtaining its ID.
  - body: { tz?: string, page?: integer, search?: string, ordering?: string, page_size?: integer, mailbox_id: string, with_result?: boolean, received_after?: string, received_before?: string }
- `POST https://api.mcp.ai/api/parseur/list/mailboxes2` — Tool to list mailboxes (parsers) with full configuration details. Returns paginated list of all mailboxes with document counts, processing statistics, and complete configuration settings. Use when you
  - body: { page?: integer, search?: string, ordering?: string, page_size?: integer }
- `POST https://api.mcp.ai/api/parseur/list/templates` — Tool to list all templates in a given mailbox. Use after fetching mailbox details when you need to page through and inspect available templates for further actions.
  - body: { page?: integer, search?: string, ordering?: string, page_size?: integer, mailbox_id: string }
- `POST https://api.mcp.ai/api/parseur/reprocess/document` — Tool to reprocess a document. Triggers re-parsing of the document with the current template configuration. Use when you need to re-parse a document after template updates or to retry failed parsing.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/parseur/retrieve/webhook` — Tool to retrieve details of a specific webhook. Use after creating or listing webhooks.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/parseur/skip/document` — Tool to skip a document. Marks the document as skipped and returns the updated document with status 'SKIPPED'.
  - body: { id: string }
- `POST https://api.mcp.ai/api/parseur/update/custom/download` — Tool to update a custom download (export configuration) for a mailbox. Use when you need to modify the field list, name, or export settings for an existing download configuration.
  - body: { id: integer, name?: string, type?: string, items?: string[], mailbox_id: string, parser_field_id?: string, parser_field_name?: string }
- `POST https://api.mcp.ai/api/parseur/update/mailbox` — Tool to update a mailbox (parser) configuration. Use when you need to modify mailbox settings such as name, AI engine, processing options, or document handling rules.
  - body: { id: integer, name?: string, ai_engine?: string, force_ocr?: boolean, odd_pages?: boolean, even_pages?: boolean, split_page?: integer, disable_deskew?: boolean, page_range_set?: object[], split_keywords?: object[], ai_instructions?: string, default_timezone?: string, retention_policy?: integer, decimal_separator?: string, input_date_format?: string, allowed_extensions?: string[], master_parser_slug?: string, process_attachments?: boolean, split_page_range_set?: object[], identification_status?: string, attachments_only_override?: boolean }
- `POST https://api.mcp.ai/api/parseur/update/webhook` — Tool to update an existing webhook’s settings. Use when you need to change the webhook’s target URL, event type, headers, or name after creation.
  - body: { name?: string, event?: string, target?: string, headers?: object, webhook_id: integer, parser_field?: string }
- `POST https://api.mcp.ai/api/parseur/upload/email/document` — Tool to upload an email or text document to Parseur for parsing. Use when you need to programmatically send documents to a Parseur mailbox.
  - body: { cc?: string, to?: string, bcc?: string, from: string, subject: string, body_html?: string, recipient: string, body_plain?: string, message_headers?: string[][] }

## Example prompts
- "What can I do in Parseur?"
- "Show me a summary of my Parseur account"

## More
- Page: https://mcp.ai/parseur
- Agent spec (llms.txt): https://mcp.ai/parseur/llms.txt
- Postman collection: https://mcp.ai/parseur/postman.json