docsapi_key

Airparser

Airparser extracts structured data from emails, documents, and other files using AI-powered parsing.

Verdict

Airparser turns unstructured documents—PDFs, emails, images—into structured data your team can query and act on. The MCP exposes ten tools that let you create parsing inboxes, upload documents, retrieve extracted fields, and manage schemas without leaving Switchy. Marketing teams use it to pull lead details from form submissions; ops teams parse invoices and receipts in bulk. You'll need an Airparser API key and enough parsing credits on your plan. The MCP won't upload files directly—you point it at documents already in an inbox or create new inboxes to receive them.

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 Inbox
    destructive

    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

  1. 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

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

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.

Prompt

@airparser list all my inboxes and show me which ones have documents waiting to be processed

Output

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.

Notes

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.

Prompt

@airparser create a new inbox called 'Supplier Quotes' that uses vision extraction to pull item descriptions, quantities, and unit prices from PDF quotes

Output

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.

Notes

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.

Prompt

@airparser get the last 5 documents from my 'Vendor Invoices' inbox and summarize any invoices over $5,000 that are due within 10 days

Output

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.

Notes

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

Invoice processing for bookkeeping

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.

Customer support ticket attachment triage

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.

Contract clause extraction for legal review

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.

More docs MCPs

See all docs MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.