# Parseur — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/parseur

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_parseur?ms=1787293680000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/parseur/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/parseur/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/parseur/skill.md
Postman collection (v2.1): https://mcp.ai/parseur/postman.json

## Tools
- parseur_copy_document(id: string, target_mailbox_id: string) — Tool to copy a document to another mailbox. Use when you need to duplicate a document from one mailbox to another mailbox within Parseur.
- parseur_copy_mailbox(id: integer) — 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.
- parseur_create_custom_download(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) — 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.
- parseur_create_mailbox(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) — 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.
- parseur_delete_custom_download(id: string, mailbox_id: string) — Tool to delete a custom download (export configuration) from a mailbox. Use when permanently removing an export configuration after confirming its ID.
- parseur_delete_document(document_id: string) — Tool to delete a specific document by ID. Use when permanently removing a document after confirming its ID.
- parseur_delete_mailbox(id: integer) — Tool to delete a mailbox (parser) by ID. Use when permanently removing a mailbox after confirming its ID.
- parseur_delete_webhook(webhook_id: integer) — Tool to delete a specific webhook. Use when permanently removing a webhook after confirming its ID.
- parseur_disable_webhook(mailbox_id: integer, webhook_id: integer) — 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.
- parseur_enable_webhook(mailbox_id: integer, webhook_id: integer) — 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 
- 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.
- parseur_get_document(id: string) — 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.
- parseur_get_document_logs(id: string, page?: integer, search?: string, ordering?: string, page_size?: integer) — 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.
- parseur_get_mailbox(id: integer) — Tool to retrieve full mailbox (parser) configuration by ID. Use when you need complete details about a specific mailbox including fields, webhooks, and settings.
- parseur_get_mailbox_schema(mailbox_id: string) — 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.
- parseur_list_custom_downloads(id: string) — Tool to retrieve custom downloads (export configurations) for a mailbox. Use when you need to list available export formats and their download URLs.
- parseur_list_documents_in_mailbox(tz?: string, page?: integer, search?: string, ordering?: string, page_size?: integer, mailbox_id: string, with_result?: boolean, received_after?: string, received_before?: string) — 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.
- parseur_list_mailboxes2(page?: integer, search?: string, ordering?: string, page_size?: integer) — 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
- parseur_list_templates(page?: integer, search?: string, ordering?: string, page_size?: integer, mailbox_id: string) — 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.
- parseur_reprocess_document(document_id: string) — 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.
- parseur_retrieve_webhook(webhook_id: string) — Tool to retrieve details of a specific webhook. Use after creating or listing webhooks.
- parseur_skip_document(id: string) — Tool to skip a document. Marks the document as skipped and returns the updated document with status 'SKIPPED'.
- parseur_update_custom_download(id: integer, name?: string, type?: string, items?: string[], mailbox_id: string, parser_field_id?: string, parser_field_name?: string) — 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.
- parseur_update_mailbox(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) — 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.
- parseur_update_webhook(name?: string, event?: string, target?: string, headers?: object, webhook_id: integer, parser_field?: string) — 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.
- parseur_upload_email_document(cc?: string, to?: string, bcc?: string, from: string, subject: string, body_html?: string, recipient: string, body_plain?: string, message_headers?: string[][]) — Tool to upload an email or text document to Parseur for parsing. Use when you need to programmatically send documents to a Parseur mailbox.

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

## Links
Docs: https://mcp.ai/docs/mcps/parseur
Website: https://mcp.ai/mcps/parseur