MCP and agents
Connect Airscale MCP to ChatGPT
Step-by-step guide to connect the Airscale MCP server to ChatGPT.
Step-by-step guide to adding Airscale MCP to ChatGPT as a custom MCP app so your AI assistant can search, enrich, and export Airscale data from a conversation.
Written by Airscale
June 14, 2026
Overview
Airscale MCP uses the Model Context Protocol to connect ChatGPT directly to your Airscale workspace.
When enabled in a conversation, ChatGPT can:
Check your Airscale credits
Search for people and companies
Discover Find Companies filter values
Enrich contacts with emails, phone numbers, personal emails, and profile data
Run AI web research with Airsearch
Export people or companies to CSV or JSONL
Authentication is handled through OAuth. You sign in with Airscale in the browser, and ChatGPT uses that session when calling Airscale MCP tools. No API keys or manual tokens are required for the ChatGPT setup.
Before you start
Make sure you have:
An Airscale account
Access to an Airscale workspace with API access
A ChatGPT Pro, Plus, Business, Enterprise, or Education account
ChatGPT web access
ChatGPT product labels can change. If the exact names below differ in your UI, look for Apps, Advanced settings, Developer Mode, Custom MCP, or Create app.
Step-by-step setup
Step 1: Open ChatGPT settings
Open ChatGPT and sign in.
Click your profile or workspace menu, then open Settings.
Step 2: Open Apps
In Settings, go to Apps.
Open Advanced settings, then enable Developer mode.
ChatGPT may show a warning when enabling custom apps or Developer Mode. This is expected for third-party MCP servers. Only connect MCP servers you trust.
Step 3: Create a new app
Click Create app next to Advanced settings.
Enter:
Leave advanced settings empty.
Confirm that you understand you are connecting a third-party MCP server, then create the app.
Step 4: Authenticate with Airscale
ChatGPT should open a browser authentication flow.
Sign in with your Airscale account, choose the workspace you want to connect, and authorize access.
After the confirmation page appears, close the browser tab and return to ChatGPT.
Step 5: Enable Airscale in a conversation
Open a new ChatGPT conversation.
Use the connector or app picker near the message input.
Choose Developer mode from the plus menu, select Airscale MCP, and confirm it is active in the chat.
Step 6: Test the connection
Ask:
If ChatGPT returns your credit balance, setup is complete.
Refreshing tools
ChatGPT may cache the MCP tool list. If Airscale adds or updates tools and you do not see them:
Go to Settings.
Open Apps.
Select Airscale MCP.
Click Refresh, if available.
If refresh is not available, remove and recreate the custom MCP app.
The live Airscale MCP server currently exposes 19 tools: 15 core public API tools and 4 export tools.
What you can do next
Search people
Search companies
Discover filter values
Enrich contacts
Export people or companies
Airscale export tools create files. They do not send thousands of rows into the chat.
Export behavior in ChatGPT
Airscale exports are asynchronous jobs.
The expected flow is:
ChatGPT starts the export and receives an export_id.
ChatGPT polls airscale_get_export_status.
ChatGPT displays status_message, progress_message, and credit fields.
When status is completed, ChatGPT calls airscale_get_export_file.
ChatGPT returns a download URL or resource link.
Large exports can take several minutes. If an export remains queued briefly, follow poll_after_seconds instead of restarting the export. Starting a second export can create another paid job.
Credits and confirmation
Airscale MCP uses the same credit behavior as the Airscale public API.
Free tools:
airscale_check_credits
airscale_count_find_people
airscale_find_companies_filter_values
Paid examples:
airscale_find_people: 0.1 credits per returned lead
airscale_find_companies: 0.1 credits per returned company
airscale_airsearch: 2 credits per call
Exported people or companies: 0.1 credits per row written
Export jobs require explicit confirmation with confirm_credit_spend: true. ChatGPT should show the estimated maximum before starting and actual credits as the job runs.
Troubleshooting
I do not see Apps or Developer Mode
Custom MCP apps require Developer Mode and a supported ChatGPT account. Check that you are using ChatGPT on the web with a Pro, Plus, Business, Enterprise, or Education account.
The authentication window opened but nothing happens
Close the browser tab after Airscale shows the confirmation page, then return to ChatGPT.
Airscale does not appear in the custom MCP picker
Make sure Developer Mode or custom apps are still enabled.
Confirm the Airscale MCP app was created successfully in Settings -> Apps.
ChatGPT cannot find Airscale tools
Refresh the Airscale MCP app from Settings -> Apps, or remove and recreate it.
Tool discovery can be cached. Starting a new chat may also force ChatGPT to reload the active tool list.
ChatGPT says an export is queued for a while
This can be normal for large exports. Ask ChatGPT to poll status using the same export_id:
When the export completes, ask:
ChatGPT tries to paste too many rows into chat
Ask it to use Airscale export tools:
Security note
Remote MCP servers give AI assistants access to external services. Only connect official MCP servers you trust. Airscale's official MCP URL is:
Airscale MCP authenticates with OAuth in ChatGPT and does not require API keys in tool arguments.
Need help?
Contact Airscale support from your Airscale workspace.
On this page