# Parsio — how to use (mcp.ai)

Connect your Parsio account and use 10 tools for document data extraction straight from your AI agent. Connect with your own API key. Parsio extracts structured data from emails, PDFs, and other documents using configurable parsers.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/parsio/get/document` — Get one Parsio document and its mailbox-specific parsed JSON fields.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/parsio/get/mailbox` — Get settings and parser configuration for one Parsio mailbox.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio/list/documents` — List and filter documents in a Parsio mailbox, one page at a time.
  - body: { query?: string, cursor?: string, status?: string[], to_date?: string, per_page?: integer, from_date?: string, mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio/list/mailboxes` — List the Parsio mailboxes available to the connected account so their IDs can be used for parsing and configuration tasks.
- `POST https://api.mcp.ai/api/parsio/list/table/fields` — List the extraction fields configured for a Parsio mailbox.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/parsio/parse/text/document` — Submit plain text or HTML to an existing template-based or GPT-powered Parsio mailbox, optionally waiting for the parsed result. This operation creates document data and consumes parsing credits.
  - body: { html?: string, name?: string, text?: string, metadata?: object, mailbox_id: string, sender_email?: string, recipient_email?: string, wait_for_result?: boolean }
- `POST https://api.mcp.ai/api/parsio/reparse/document` — Queue an existing Parsio document to be parsed again. This operation consumes parsing capacity or credits and should not be retried blindly.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/parsio/skip/documents` — Mark one or more documents in a Parsio mailbox as skipped. This changes their processing state and cannot be undone through this toolkit.
  - body: { mailbox_id: string, document_ids: string[] }
- `POST https://api.mcp.ai/api/parsio/update/mailbox` — Update one or more settings on an existing Parsio mailbox. Provide at least one setting; omitted settings remain unchanged.
  - body: { name?: string, mailbox_id: string, email_prefix?: string, alert_email_h?: integer, receive_email?: boolean, collect_emails?: boolean, process_attachments?: boolean }
- `POST https://api.mcp.ai/api/parsio/upload/document` — Upload one file to a Parsio mailbox for parsing, optionally waiting for the parsed result. This operation creates document data and consumes parsing credits.
  - body: { file: object, metadata?: object, mailbox_id: string, wait_for_result?: boolean }

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

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