Airparser
Airparser extracts structured data from emails, documents, and other files using AI-powered parsing.
Verdict
Common use cases
- Extract invoice line items from email attachments
- Parse job applications into a hiring spreadsheet
- Pull product specs from supplier PDFs
- Monitor form submissions and route to CRM
- Audit receipt data for expense reconciliation
Integration
- Vendor
- Airparser
- Category
- docs
- Auth
- API_KEY
- Tools
- 10
- Composio slug
airparser
Tools
- Clone Extraction Schema
Replace a destination inbox's extraction schema with a copy of a source inbox's schema.
- Create Inbox
Create an Airparser inbox/parser for a document family using a text or vision extraction engine.
- Delete Inboxdestructive
Permanently delete an Airparser inbox and every document it contains. This destructive, cascading operation cannot be undone and requires explicit confirmation.
- Get Account Usage
Return the connected Airparser account's role, verification state, plan, and parsing-credit usage without exposing personal, secret, or internal account fields.
- Get Document
Get parsed output and status for a document, optionally including extended source and navigation details.
- Get Inbox
Get one Airparser inbox, including its current extraction schema and useful parsing configuration.
- List Documents
List and search documents in one inbox, one page at a time.
- List Inboxes
List the Airparser inboxes available to the connected account.
- Parse Document Synchronously
Upload one document to an inbox and wait for its extracted JSON. This non-idempotent operation consumes plan credits, including one credit per PDF page. Do not retry automatically after an ambiguous failure because a retry can consume credi
- Upsert Extraction Schema
Create or completely replace the extraction schema used by an Airparser inbox. The fields array is the complete replacement, not a partial update.
Setup
Setup guide
- 11. Open your Switchy workspace settings and navigate to the Integrations tab. 2. Search for Airparser in the MCP directory and click Connect. 3. Log in to your Airparser account, go to Settings > API Keys, and generate a new key with full read-write access. 4. Paste the key into Switchy's auth modal and click Authorize. 5. Return to any Project and type '@Airparser list my inboxes' to confirm the connection—you should see your existing parsers. 6. To test extraction, pick an inbox ID from the list and run '@Airparser get inbox [ID]' to inspect its schema. 7. Upload a sample document through Airparser's web UI, then ask '@Airparser list documents in inbox [ID]' to verify Switchy can read parsed results. 8. Once you see structured output, you're ready to automate parsing workflows inside Projects.
What teammates see: by default, memories from Airparser are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Audit Inbox Usage
@Airparser show me my account usage, then list all my inboxes and tell me which ones have processed documents in the past seven days.
Clone a Schema
@Airparser clone the extraction schema from inbox [source_id] into inbox [destination_id] and confirm the fields copied over.
Retrieve Parsed Data
@Airparser get document [doc_id] from inbox [inbox_id] and show me the extracted fields in a markdown table.
Search Recent Documents
@Airparser list documents in inbox [inbox_id] from the past week and highlight any that failed to parse.
Set Up New Parser
@Airparser create a new inbox called 'Q1 Invoices' using the text extraction engine, then show me its inbox ID and schema.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@airparser list all my inboxes and show me which ones have documents waiting to be processed
Found 4 active inboxes in your Airparser account. **Vendor Invoices** (12 documents, last upload 2 hours ago) uses GPT-4 Vision for PDF extraction. **Customer Contracts** (3 documents) uses text extraction with a 15-field schema. **Expense Reports** (0 documents) is configured but empty. **Meeting Notes** (47 documents) has the highest volume this month. All inboxes are on your Pro plan with 8,200 parsing credits remaining this billing cycle.
This example demonstrates read-only discovery across the account. Requires a valid API key with inbox-read scope. The MCP does not auto-parse documents—it surfaces what Airparser has already processed. Useful for auditing which document families you're tracking and where parsing bottlenecks exist.
@airparser create a new inbox called 'Supplier Quotes' that uses vision extraction to pull item descriptions, quantities, and unit prices from PDF quotes
Created inbox **Supplier Quotes** (ID: `ibx_9k3mq7`) with GPT-4 Vision engine. The extraction schema includes three fields: `item_description` (text), `quantity` (number), and `unit_price` (currency). You can now forward supplier quote PDFs to the inbox's unique email address or upload via API. Each document will consume ~50 parsing credits depending on page count and complexity. Schema can be refined after reviewing initial extractions.
This write operation provisions a new parser and consumes account resources. Vision-based extraction works well for scanned or image-heavy PDFs but costs more credits than text extraction. You'll need to iterate on the schema—first-pass field definitions rarely capture every edge case in real supplier documents.
@airparser get the last 5 documents from my 'Vendor Invoices' inbox and summarize any invoices over $5,000 that are due within 10 days
Retrieved 5 most recent documents from **Vendor Invoices**. Two invoices exceed $5,000 and are due soon: **Acme Supply Co.** ($7,340 due March 18) for industrial components, and **Metro Logistics** ($12,800 due March 15) covering February shipping. Both documents parsed successfully with high confidence scores. The other three invoices are under $3,000 or due after March 25. All extraction timestamps are within the last 48 hours, so data is current.
This synthesis example combines the MCP's document-retrieval tool with the AI's filtering and summarization logic. The MCP returns structured extraction output (amounts, dates, vendor names); the AI applies your business rules. Accuracy depends on Airparser's schema quality—if the inbox wasn't trained to extract due dates, this query will fail silently.
Use-case deep-dives
When Airparser beats manual entry for recurring vendor invoices
A three-person accounting firm handles 40-60 vendor invoices a week across five clients. Each invoice arrives as a PDF attachment with different layouts—utilities, SaaS subscriptions, contractors. Airparser wins here because you create one inbox per vendor type, train the extraction schema once using the vision engine, then forward invoices to the inbox email. The Get Document and List Documents tools let your team pull parsed line items into QuickBooks or Xero without re-keying. The break-even point is around 15 invoices a month per vendor; below that, manual entry is faster than schema tuning. If your invoices are truly one-off (new vendors every week), the setup tax outweighs the benefit. For stable vendor rosters, this MCP turns email into structured data with two minutes of schema work up front.
Airparser for high-volume attachment parsing in support queues
A 12-person SaaS support team gets 200 tickets a day, and 30 percent include screenshots, logs, or error PDFs. The team needs to route tickets by severity and product area, but agents waste 90 seconds per attachment deciding if it's urgent. Airparser's text and vision engines can parse common attachment types—stack traces, browser console logs, annotated screenshots—into structured fields that feed your triage rules. Create one inbox for logs, one for screenshots, use List Documents to poll new arrivals every five minutes, then tag tickets in Zendesk or Intercom based on parsed severity markers. The constraint: if your attachment formats change weekly (custom client exports, ad-hoc spreadsheets), you'll spend more time updating schemas than you save. This MCP shines when 70 percent of attachments fit three or four repeating templates.
When Airparser accelerates NDA and MSA review cycles
A two-lawyer startup reviews 10-15 NDAs and MSAs a month before signing with vendors or partners. Each contract is a 6-20 page PDF with standard clauses buried in different sections—liability caps, termination terms, indemnification language. Airparser's vision engine can extract those clauses into a comparison table if you build one inbox per contract type and define the schema around your must-check fields. Use Get Inbox to confirm the schema matches your review checklist, then forward signed PDFs to the inbox and pull parsed clauses with Get Document. The trade-off: if every contract is bespoke (custom riders, foreign jurisdictions, heavily redlined), the extraction accuracy drops below 80 percent and you're back to manual review. For repeating contract forms from the same three law firms, this MCP cuts first-pass review from 20 minutes to two.
Frequently asked
What does the Airparser MCP do in Switchy?
It connects your Airparser account so AI agents can create document parsers, upload files for extraction, and retrieve structured data from PDFs, emails, and images. Your team can automate document workflows—like pulling invoice line items or parsing resumes—without writing custom code or switching between tools.
Do I need an Airparser API key to connect this MCP?
Yes. Switchy uses API key authentication, so you'll need to generate one from your Airparser dashboard. The key grants access to all inboxes and documents under your account, so only connect it if you're comfortable giving AI agents read-write access to your parsing setup.
Can the MCP upload documents directly to Airparser for parsing?
No. The current tool set lets agents create inboxes, clone schemas, and retrieve parsed results, but it doesn't include a direct upload endpoint. You'll still send documents to Airparser via email or their web interface, then use the MCP to fetch the extracted data once parsing completes.
How is this different from calling Airparser's API myself?
The MCP wraps Airparser's API in natural-language tools, so your AI agents can discover inboxes, check usage, and pull documents without you writing integration code. If you already have a custom pipeline, stick with the API. If you want agents to handle ad-hoc parsing requests, the MCP saves setup time.
Who on my team should connect the Airparser MCP?
Whoever owns your Airparser account and understands which inboxes contain sensitive data. Because the MCP can delete inboxes and documents, connect it in a Switchy workspace where only trusted teammates can invoke those destructive tools. Parsing credits count against your Airparser plan, not Switchy's.