Airparser MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'airparsermcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Airparser MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'airparsermcp_get_extraction_schema_format_guide',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "airparsermcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Airparser MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="airparsermcp_get_extraction_schema_format_guide",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Sync upload document — Upload one document to an Airparser inbox and wait for the parsed result
• Update fields meta, extraction schema from json schema, extraction schema — Enable or disable per-document output metadata fields for an Airparser inbox
• Code test postprocessing, save postprocessing — Run Airparser post-processing Python code against an existing parsed document without saving it
• Enabled set postprocessing — Enable or disable the saved Airparser post-processing step for an inbox
• List inboxes, documents — List active Airparser inboxes available to the authenticated user
• Get postprocessing runtime rules, postprocessing, inbox — Get the runtime constraints and allowed imports for Airparser post-processing Python code

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

airparsermcp_create_inbox#Create a new Airparser inbox with the selected LLM engine.2 params▾

Create a new Airparser inbox with the selected LLM engine.

NameTypeRequiredDescription

llm_enginestringrequiredParsing engine: 'text' for text-based documents, 'vision' for image-based documents.

namestringrequiredHuman-friendly inbox name.

airparsermcp_generate_schema_from_document#Generate an Airparser extraction schema proposal from an existing document in an inbox.2 params▾

Generate an Airparser extraction schema proposal from an existing document in an inbox.

NameTypeRequiredDescription

document_idstringrequiredExisting document id inside that inbox.

inbox_idstringrequiredAirparser inbox id.

airparsermcp_get_document#Get one Airparser document with parsed JSON for the authenticated user.1 param▾

Get one Airparser document with parsed JSON for the authenticated user.

NameTypeRequiredDescription

document_idstringrequiredAirparser document id.

airparsermcp_get_extraction_schema#Get the current extraction schema configured for an Airparser inbox.1 param▾

Get the current extraction schema configured for an Airparser inbox.

NameTypeRequiredDescription

inbox_idstringrequiredAirparser inbox id.

airparsermcp_get_extraction_schema_format_guide#Get a compact guide to the native Airparser extraction schema format, including field types and examples.0 params▾

Get a compact guide to the native Airparser extraction schema format, including field types and examples.

airparsermcp_get_inbox#Get a single Airparser inbox, including extraction schema details.1 param▾

Get a single Airparser inbox, including extraction schema details.

NameTypeRequiredDescription

inbox_idstringrequiredAirparser inbox id.

airparsermcp_get_postprocessing#Get the current Airparser post-processing configuration for an inbox, including whether it is enabled and the saved Python code.1 param▾

Get the current Airparser post-processing configuration for an inbox, including whether it is enabled and the saved Python code.

NameTypeRequiredDescription

inbox_idstringrequiredAirparser inbox id.

airparsermcp_get_postprocessing_runtime_rules#Get the runtime constraints and allowed imports for Airparser post-processing Python code.0 params▾

Get the runtime constraints and allowed imports for Airparser post-processing Python code.

airparsermcp_list_documents#List documents inside an Airparser inbox, including recent parsed results and pagination metadata.4 params▾

List documents inside an Airparser inbox, including recent parsed results and pagination metadata.

NameTypeRequiredDescription

inbox_idstringrequiredAirparser inbox id.

fromstringoptionalStart date filter in YYYY-MM-DD format.

pageintegeroptional1-based page number for pagination.

tostringoptionalEnd date filter in YYYY-MM-DD format.

airparsermcp_list_inboxes#List active Airparser inboxes available to the authenticated user.0 params▾

List active Airparser inboxes available to the authenticated user.

airparsermcp_save_postprocessing_code#Save Airparser post-processing Python code for an inbox without changing whether it is enabled.2 params▾

Save Airparser post-processing Python code for an inbox without changing whether it is enabled.

NameTypeRequiredDescription

codestringrequiredPython function body to save.

inbox_idstringrequiredAirparser inbox id.

airparsermcp_set_postprocessing_enabled#Enable or disable the saved Airparser post-processing step for an inbox.2 params▾

Enable or disable the saved Airparser post-processing step for an inbox.

NameTypeRequiredDescription

inbox_idstringrequiredAirparser inbox id.

is_enabledbooleanrequiredWhether post-processing should be enabled.

airparsermcp_test_postprocessing_code#Run Airparser post-processing Python code against an existing parsed document without saving it.3 params▾

Run Airparser post-processing Python code against an existing parsed document without saving it.

NameTypeRequiredDescription

codestringrequiredPython function body to run inside the restricted Airparser post-processing wrapper.

document_idstringrequiredParsed Airparser document id.

inbox_idstringrequiredAirparser inbox id.

airparsermcp_update_extraction_schema#Create or update the extraction schema for an Airparser inbox using the native validated schema format.2 params▾

Create or update the extraction schema for an Airparser inbox using the native validated schema format.

NameTypeRequiredDescription

fieldsarrayrequiredExtraction schema fields in Airparser native format. Each field object must use "name" (not "key") as the field identifier.

inbox_idstringrequiredAirparser inbox id.

airparsermcp_update_extraction_schema_from_json_schema#Convert an OpenAI-style schema description into the native Airparser extraction schema format and save it to an inbox.2 params▾

Convert an OpenAI-style schema description into the native Airparser extraction schema format and save it to an inbox.

NameTypeRequiredDescription

fieldsarrayrequiredOpenAI-style field definitions to convert. Each item has name, description, type, and optional attributes.

inbox_idstringrequiredAirparser inbox id.

airparsermcp_update_fields_meta#Enable or disable per-document output metadata fields for an Airparser inbox. Only passed fields are changed; omitted fields keep their current value.2 params▾

Enable or disable per-document output metadata fields for an Airparser inbox. Only passed fields are changed; omitted fields keep their current value.

NameTypeRequiredDescription

fields_metaobjectrequiredPartial set of metadata fields to enable/disable. Optional boolean properties: from, from_name, original_recipient, to, cc, bcc, reply_to, subject, received_at_datetime, received_at_date, received_at_time, attachments_nb, doc_id, doc_url, content_type, content, content_plaintext, content_plaintext_md, download_url, parent_id, parent_data, name, filename, credits, pages, confidence.

inbox_idstringrequiredAirparser inbox id.

airparsermcp_upload_document_sync#Upload one document to an Airparser inbox and wait for the parsed result. File content must be base64 encoded.5 params▾

Upload one document to an Airparser inbox and wait for the parsed result. File content must be base64 encoded.

NameTypeRequiredDescription

content_base64stringrequiredBase64-encoded file contents.

content_typestringrequiredMIME type of the document.

filenamestringrequiredOriginal filename including extension.

inbox_idstringrequiredTarget Airparser inbox id.

metadataobjectoptionalOptional metadata key-value pairs to attach.