# Parsio MCP for AI Agents AI Agent Connect > Parsio MCP lets you turn messy PDFs, images, and emails into structured data instantly. It connects your Parsio account to your AI agent so you can pull specific fields like invoice totals or shipping dates without manual data entry. It handles the heavy lifting of parsing, letting you focus on the actual work. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_yShmYVprqkrBa4Zva83RntWeb6xLfJgwiMMltVID/ai-agent-connect - **Tags:** ocr, data-extraction, pdf-parsing, email-automation, json-conversion, unstructured-data ## Description This Connector lets you connect your Parsio account to your AI agent so you can manage document automation through a simple chat. If you're tired of manually typing out data from invoices, receipts, or messy emails, this setup lets your agent do the heavy lifting for you. It handles the process of turning unstructured files into clean JSON data that you can actually use in your workflows. You can ask your agent to pull specific details from a document, check your parsing templates, or look up historical records without ever leaving your chat interface. By including this in the Vinkius catalog, it provides a straightforward way to bridge the gap between your physical documents and your digital systems. You get to move away from copy-pasting and toward a system where your AI handles the data entry, leaving you with the actual results you need to get your work done. ## Tools ### get_template_details See the specific settings and metadata for a parsing template. Use this to understand how your data is being structured. ### list_mailboxes Get a full list of all your mailboxes to see how your data is organized. It gives you a high level view of your document containers. ### list_parsed_data_history Look through the history of documents that have been parsed in a specific mailbox. This helps you audit past results quickly. ### list_mailbox_templates See every parsing template currently active for a specific mailbox. It lets you manage your templates in one view. ### list_mailbox_webhooks Check the webhooks associated with a mailbox to monitor your data flows. This ensures your automated connections are still active. ### extract_data_from_text_sync Pull data from text or HTML immediately so you can see the results in your chat right away. This works best for short snippets of text. ### extract_data_from_file_async Start a background extraction for large files or when setting up a webhook. Use this for heavy lifting that doesn't need a real-time response. ### extract_data_from_file_sync Extract data from a file right now for a quick, real-time result. This is perfect for one-off tasks like reading a single receipt. ### create_mailbox Create a new mailbox to organize different types of incoming documents. This keeps your data streams separated and easy to manage. ### extract_data_from_text_async Start a background process to pull data from text or HTML when you don't need the result immediately. This is great for large text blocks. ### get_parsed_document_result Pull the final structured data from a document that has already been processed. It lets you see the exact results of a parse. ### get_mailbox View the specific configuration and metadata for a single mailbox. This is useful for checking your current mailbox settings. ## Prompt Examples **Prompt:** ``` List my mailboxes and tell me how many templates are in each. ``` **Response:** ``` I've pulled your mailbox list. Here is what's currently set up: | Mailbox Name | Templates | Status | | :--- | :--- | :--- | | **Sales Invoices** | 4 | Active | | **Expense Receipts** | 2 | Active | | **Shipping Labels** | 1 | Active | Would you like to see the specific details for any of these? ``` **Prompt:** ``` Extract the total amount and date from the invoice I just uploaded. ``` **Response:** ``` I've processed that invoice for you. Here are the details: * **Total Amount:** $1,450.00 * **Date:** October 12, 2023 * **Vendor:** Acme Corp * **Status:** Verified I've also saved this to your 'Sales Invoices' mailbox. ``` **Prompt:** ``` Show me the parsed data for the last 5 documents in my 'Receipts' mailbox. ``` **Response:** ``` Here are the last 5 parsed receipts from your 'Receipts' mailbox: 1. **Starbucks** - $5.50 (Oct 14) 2. **Shell Gas** - $65.20 (Oct 13) 3. **Uber** - $22.10 (Oct 12) 4. **Whole Foods** - $88.45 (Oct 11) 5. **Delta Airlines** - $340.00 (Oct 10) All 5 records were extracted with 100% confidence. ``` ## Capabilities ### Pull structured data from files Extract specific fields from PDFs, images, or HTML into a clean format. ### Manage multiple mailboxes Organize different data streams into separate containers for cleaner processing. ### View parsing templates See how your documents are being structured and managed in your account. ### Retrieve historical records Look up past parsing results for any specific mailbox or document. ### Monitor automation health Check your webhooks and system responses to ensure your data flows are active. ## Use Cases ### Processing Invoices A finance person asks the agent to pull the total and tax from the last 10 uploaded PDFs using extract_data_from_file_sync. ### Mailbox Organization An ops manager wants to see all their active mailboxes and create a new one for 'Shipping Labels' using create_mailbox. ### Data Auditing A developer needs to check the success rate of a specific template and view the results of the last 5 docs using get_template_details and get_parsed_document_result. ### Bulk Text Processing An admin wants to turn a long HTML page into a JSON list and uses extract_data_from_text_async to handle it in the background. ## Benefits - Stop manual data entry by using extract_data_from_file_sync to pull specific fields from invoices immediately. This lets you skip the copy-paste cycle and get your data into your system in seconds. - Keep your document pipelines organized by using list_mailboxes to see all your active containers. You can easily manage different types of data like receipts and shipping labels in separate areas. - Monitor your automation health by using list_mailbox_webhooks to verify your connections. It ensures your data flows are always active and you won't miss any updates from your documents. - Audit your historical data with list_parsed_data_history to find old records for specific mailboxes. You can quickly look up past results without having to search through your entire archive. - Manage your parsing logic with list_mailbox_templates to see how your documents are being structured. This gives you a clear view of your automation rules and helps you keep your data clean. ## How It Works The bottom line is you get a way to turn any document into usable data through a simple chat interface. 1. Subscribe to the Connector and grab your API key from your Parsio account settings. 2. Connect the key to your AI client to link your document pipelines. 3. Ask your agent to parse a file, list your mailboxes, or check a template. ## Frequently Asked Questions **Can the Parsio MCP read my emails?** Yes, it can pull data from emails if you have a mailbox set up. It connects to your Parsio account to extract structured info from your messages. **Does the Parsio MCP support large PDF files?** Yes, it includes a specific tool for large file extraction that runs in the background. This prevents your chat from hanging while processing heavy documents. **How do I use the Parsio MCP to organize different types of documents?** You can create separate mailboxes for different categories like invoices, receipts, or shipping labels. This keeps your data streams clean and easy to manage. **Can I see my past parsed results with the Parsio MCP?** Yes, you can list the history of parsed data for any specific mailbox. This is perfect for auditing past records or double-checking previous extractions. **Is the Parsio MCP good for high-volume data entry?** It's built exactly for that. It turns manual data entry into automated extraction, allowing your AI agent to handle hundreds of documents without manual effort. **Can I check if my webhooks are working with the Parsio MCP?** Yes, you can list your webhooks to verify your automation is connected. It helps ensure your data flows are always active and syncing correctly. **Can my AI automatically find the parsed results for a specific invoice URL?** Yes! Use the `upload_file_sync` tool. Provide the file URL and the Mailbox ID, and your agent will respond with the structured JSON data extracted from the document in seconds. **How do I find my Parsio API Key?** Log in to your Parsio account, navigate to **Account Settings** > **API**, and you will find your unique secret API key there. **Does it support hand-written text recognition?** Absolutely. Parsio's AI-powered OCR engine is designed to handle both printed and hand-written text from scanned images and PDFs with high accuracy.