How to Use the Airparser MCP in Cursor

Q: How do I add the Airparser MCP Server to my Cursor editor?

Add the server to your .cursor/mcp.json file in your project root or global config. Once added, Cursor's AI agent can immediately call the extraction tools during your coding sessions.

Q: Can Cursor automatically map my Airparser inbox fields to TypeScript interfaces?

Yes, Cursor can call getinboxschema to read your Airparser configuration. It then uses that schema to generate exact TypeScript interfaces directly in your codebase.

Q: How does Cursor handle large document uploads to Airparser?

Cursor uses the parsedocumentsync tool for immediate files, or parsedocumentasync for larger background tasks. This lets you trigger document parsing right from your editor terminal or chat.

Q: Can I list my active document inboxes inside the editor?

Yes, you can ask the agent to run listinboxes to see all your active parser configurations. This helps you select the correct target inbox when writing ingestion scripts.

Feed clean, parsed JSON data directly into your Cursor code editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Airparser MCP to Cursor

Create your Vinkius account to connect Airparser to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Airparser with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Write Cursor code using real Airparser schemas

The `get_inbox_schema` tool pulls your live Airparser field definitions directly into your active workspace. Stop writing mock data structures for your parser integrations. With the actual schema loaded, Cursor writes typed code that matches your extracted data perfectly. It eliminates the guesswork of mapping complex PDF outputs to your local database models.

Inspect live document payloads during debugging

The `get_document_details` tool pulls actual extracted JSON from your inbox into your editor context so you can verify how your code handles real payloads. This eliminates switching to an API client to copy-paste test data. Instead of guessing what the response looks like, you get raw data directly in Cursor. It makes debugging your document ingestion pipelines incredibly fast.

Configure webhooks during local development

The `create_webhook` tool registers your local development tunnel with Airparser to test incoming data streams. You can configure these pathways directly through the Cursor agent. If you need to swap endpoints or clean up test hooks, the Cursor agent can execute `delete_webhook` or `list_webhooks` to manage your active integrations without leaving your code.

Setup guide

Set up Airparser MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Airparser MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Airparser transactions." If the MCP tools are loaded correctly, Cursor will call the Airparser tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "airparser-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Airparser. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Airparser now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Airparser MCP in Cursor

Add the server to your `.cursor/mcp.json` file in your project root or global config. Once added, Cursor's AI agent can immediately call the extraction tools during your coding sessions.

Yes, Cursor can call `get_inbox_schema` to read your Airparser configuration. It then uses that schema to generate exact TypeScript interfaces directly in your codebase.

Cursor uses the `parse_document_sync` tool for immediate files, or `parse_document_async` for larger background tasks. This lets you trigger document parsing right from your editor terminal or chat.

Yes, you can ask the agent to run `list_inboxes` to see all your active parser configurations. This helps you select the correct target inbox when writing ingestion scripts.

Your PDFs, emails, and extracted JSON data are transmitted directly between Cursor and the Airparser API. Vinkius secures this channel using isolated runtimes, keeping your proprietary business data safe from exposure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript