# Parsio.io — how to use (mcp.ai)

Connect your Parsio.io account and use 24 tools for document data extraction straight from your AI agent. Connect with your own API key. No-code email parser to extract and export valuable data from emails, PDFs and documents.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_parsio_io?ms=1787291400000`
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. `parsio_io_create_html_text_document`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/parsio_io`
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/parsio_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/parsio_io/create/html/text/document` — Tool to create and parse HTML or text documents via API. Use when you need to submit HTML or text content to a Parsio mailbox for data extraction. At least one of html or text must be provided.
  - body: { to?: string, from?: string, html?: string, meta?: object, name: string, text?: string, mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/create/mailbox` — Tool to create a new mailbox with a specified name. Use when you need to set up a new mailbox for email parsing in Parsio.
  - body: { name: string }
- `POST https://api.mcp.ai/api/parsio_io/create/webhook` — Tool to create a new webhook for a mailbox with specified URL, event trigger, and settings. Use when you need to register a webhook endpoint to receive automated notifications for mailbox events.
  - body: { url: string, event: string, enabled: boolean, table_id?: string, mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/delete/mailbox` — Tool to delete a specific mailbox from your Parsio account. Use when you need to permanently remove a mailbox.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/delete/templates` — Tool to delete multiple templates by providing an array of template IDs. Use when you need to remove one or more templates from a mailbox.
  - body: { ids: string[] }
- `POST https://api.mcp.ai/api/parsio_io/delete/webhooks` — Tool to delete multiple webhooks from a mailbox. Use when you need to remove one or more webhook configurations by providing their IDs.
  - body: { ids: string[] }
- `POST https://api.mcp.ai/api/parsio_io/disable/templates` — Tool to disable multiple templates by providing an array of template IDs. Use when you need to deactivate multiple templates in a mailbox.
  - body: { ids: string[] }
- `POST https://api.mcp.ai/api/parsio_io/enable/templates` — Tool to enable multiple templates by providing an array of template IDs. Use when you need to activate multiple templates for use in a mailbox.
  - body: { ids: string[] }
- `POST https://api.mcp.ai/api/parsio_io/get/document` — Tool to retrieve a specific document with parsed data as JSON. Use when you need to fetch details of a document by its ID.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/parsio_io/get/mailbox` — Tool to retrieve details of a specific mailbox. Use when you need to fetch configuration and settings for a particular mailbox.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/get/parsed/data` — Tool to get parsed data from a mailbox with optional date range filters and pagination. Use when you need to retrieve extracted information from documents that have been processed through Parsio's par
  - body: { to?: string, from?: string, page?: integer, mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/get/template` — Tool to retrieve details of a specific parsing template by its ID. Use when you need to inspect a template's configuration, fields, or status.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/parsio_io/get/webhook` — Tool to retrieve details of a specific webhook by its ID. Use when you need to inspect a webhook's configuration, status, or event type.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/parsio_io/list/collected/emails` — Tool to list all collected email addresses from a specific mailbox. Use when you need to retrieve email addresses that have been automatically collected during document parsing. The mailbox must have 
  - body: { page?: integer, mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/list/documents` — Tool to retrieve a list of documents from a specific mailbox. Use when you need to list documents with optional filtering by date range, search query, or processing status. Supports pagination for lar
  - body: { q?: string, to?: string, from?: string, page?: integer, status?: string[], mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/list/mailboxes` — Tool to retrieve all mailboxes in the account. Use when you need to list all available mailboxes and their configurations.
- `POST https://api.mcp.ai/api/parsio_io/list/table/fields` — Tool to list all table fields in a specific mailbox. Use when you need to view the structure of data fields available for a mailbox.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/list/templates` — Tool to list all parsing templates associated with a specific mailbox. Use when you need to retrieve all template configurations for a mailbox, including their enabled status and metadata. Supports pa
  - body: { page?: integer, mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/list/webhooks` — Tool to retrieve all webhooks configured for a specific mailbox. Use when you need to list webhooks associated with a mailbox.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/parse/document` — Tool to trigger parsing of a specific document. Use when you need to initiate parsing for a document that has already been uploaded or created in Parsio.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/parsio_io/skip/documents` — Tool to skip multiple documents in a mailbox by providing document IDs. Use when you need to mark documents as skipped rather than parsing them.
  - body: { ids: string[], mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio_io/update/mailbox` — Tool to update mailbox settings including name, email prefix, and processing options. Use when you need to modify configuration settings for an existing mailbox.
  - body: { name?: string, mailbox_id: string, email_prefix?: string, alert_email_h?: integer, collect_emails?: boolean, process_attachments?: boolean }
- `POST https://api.mcp.ai/api/parsio_io/update/webhook` — Tool to update an existing webhook's configuration. Use when you need to modify webhook settings like URL, event type, or activation status.
  - body: { _id: string, url: string, event: string, enabled: boolean, table_id?: string }
- `POST https://api.mcp.ai/api/parsio_io/upload/file` — Tool to upload and parse PDF, HTML, CSV, TXT, DOCX, RTF or XML files (max 20MB) to a mailbox. Use when you need to submit a file to Parsio for automated data extraction.
  - body: { file: object, meta?: object, mailbox_id: string }

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

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