MCP and agents

Connect Airscale MCP to ChatGPT

Step-by-step guide to connect the Airscale MCP server to ChatGPT.

Use Airscale MCP to let ChatGPT search, enrich, research, and export Airscale data directly from a conversation.

MCP server URL

Use this remote MCP server URL:

https://mcp.airscale.io/mcp

This is the official Airscale MCP endpoint. Paste this exact URL when ChatGPT asks for an MCP server URL.

Airscale MCP uses OAuth in ChatGPT. You sign in with Airscale in the browser, and ChatGPT uses that Airscale session when calling MCP tools. Do not paste an Airscale API key into ChatGPT for the OAuth setup.

The selected Airscale workspace still needs API access enabled and an active Airscale API key. OAuth resolves that workspace API key behind the scenes when tools run.

What ChatGPT can do with Airscale MCP

When Airscale MCP is enabled in a ChatGPT conversation, ChatGPT can:

  • Check your Airscale credits.

  • Search for people and companies.

  • Discover accepted Find Companies filter values.

  • Enrich contacts with professional emails, phone numbers, personal emails, and profile data.

  • Run AI web research with Airsearch.

  • Export people or companies to CSV or JSONL.

The live Airscale MCP server currently exposes 22 tools: 15 core public API tools, 4 people/company export tools, and 3 managed contact-enrichment batch/export tools.

Managed large contact-enrichment exports currently support work-email enrichment. Phone, personal email, and profile enrichment are available through their respective MCP tools.

Before you start

Make sure you have:

  • An Airscale account.

  • Access to an Airscale workspace with API access enabled.

  • An active Airscale API key on that workspace.

  • 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 on the web and sign in.

Open Settings from your profile or workspace menu.

Step 2: Enable Developer Mode

In Settings, go to Apps.

Open Advanced settings.

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 the Airscale MCP app

Click Create app next to Advanced settings.

Enter the name:

Airscale MCP

Enter the MCP server URL:

https://mcp.airscale.io/mcp

Leave advanced settings empty unless your workspace has a specific policy.

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 Airscale workspace you want to connect.

Authorize access.

After Airscale shows the confirmation page, close the browser tab and return to ChatGPT.

Step 5: Enable Airscale MCP in a conversation

Open a new ChatGPT conversation.

Open the plus menu near the message input.

Choose Developer mode.

Select Airscale MCP.

Confirm that Airscale MCP is active in the chat before asking it to use Airscale.

Step 6: Test the connection

Ask:

Check my Airscale credits.

If ChatGPT returns your workspace credit balance, setup is complete.

This is the safest first test because it verifies authentication without running a paid search, enrichment, or export.

Recommended first prompts

Use these prompts to keep ChatGPT on the Airscale MCP tools instead of built-in browsing or unrelated connectors.

Check credits:

Use Airscale MCP to check my Airscale credits.

Search people:

Use Airscale MCP to find marketing directors at software companies in the US.

Search companies:

Use Airscale MCP to find fintech companies in the UK with 11 to 50 employees.

Discover filter values:

Use Airscale MCP to show accepted Find Companies industry values for "software".

Enrich contacts:

Use Airscale MCP to find professional emails for these LinkedIn profiles.

Export people or companies:

Use Airscale MCP export tools to export up to 10,000 matching people as CSV. Do not paste the full result set into chat.

Export behavior in ChatGPT

Airscale exports are asynchronous jobs.

The expected flow is:

  1. ChatGPT starts the export and receives an export_id.

  2. ChatGPT polls airscale_get_export_status.

  3. ChatGPT displays status_message, progress_message, and credit fields.

  4. When status is completed, ChatGPT calls airscale_get_export_file.

  5. ChatGPT returns a download URL or resource link.

Airscale export tools create downloadable files. They do not send thousands of rows into the chat.

Large exports can take several minutes. If an export remains queued briefly, follow poll_after_seconds instead of restarting the export. Starting a duplicate export can create another paid job.

If ChatGPT seems stuck, ask:

Keep polling this Airscale export using airscale_get_export_status. Follow poll_after_seconds and do not start a duplicate export.

When the export completes, ask:

Get the file for this Airscale export_id.

Credits and confirmation

Airscale MCP uses the same credit behavior as the Airscale public API.

Free examples:

  • airscale_check_credits

  • airscale_count_find_people

  • airscale_find_companies_filter_values

  • airscale_create_contact_enrichment_batch

  • airscale_add_contacts_to_enrichment_batch

  • airscale_get_export_status

  • airscale_get_export_file

Paid examples:

  • airscale_find_people: 0.1 credits per returned lead.

  • airscale_find_companies: 0.1 credits per returned company.

  • airscale_airsearch: 1 credit per call.

  • work-email contact enrichment: 2 credits, only if the email is found (and verified)

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

Review ChatGPT tool-call confirmations before approving paid actions. Tools without a read-only annotation may be treated as write actions and can require confirmation.

Refreshing tools

ChatGPT may cache the MCP tool list. If Airscale adds or updates tools and you do not see them:

  1. Go to Settings.

  2. Open Apps.

  3. Select Airscale MCP.

  4. Click Refresh if available.

  5. If Refresh is not available, remove and recreate the custom MCP app.

  6. Start a new chat and select Airscale MCP again from Developer mode.

Troubleshooting

I do not see Apps or Developer Mode

Custom MCP apps require Developer Mode and a supported ChatGPT account on the web. Check that you are using ChatGPT with a Pro, Plus, Business, Enterprise, or Education account.

Create app is missing

The Create app button only appears after Developer mode is enabled. Go to Settings > Apps > Advanced settings and enable Developer mode first.

The authentication window opened but ChatGPT still looks stuck

Close the browser tab after Airscale shows the confirmation page, then return to ChatGPT.

Airscale does not appear in the Developer Mode picker

Make sure Developer Mode is still enabled.

Confirm that the Airscale MCP app was created successfully in Settings > Apps.

Start a new chat and open the plus menu again.

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.

Authentication succeeds but tools fail

Check the selected Airscale workspace:

  • API access must be enabled.

  • The workspace must have an active Airscale API key.

  • The authenticated user must have access to that workspace.

  • The workspace must have enough credits for paid tools.

OAuth signs the user in, but tool calls still depend on the workspace API key that Airscale resolves server-side.

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:

Keep polling this Airscale export using airscale_get_export_status. Follow poll_after_seconds and do not start a duplicate export.

When the export completes, ask:

Get the file for this Airscale export_id.

ChatGPT tries to paste too many rows into chat

Ask it to use Airscale export tools:

Do not paginate the full result set through chat. Use Airscale's export tools and return the downloadable CSV link.

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:

https://mcp.airscale.io/mcp

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.

Next

Connect Airscale MCP to Claude

On this page

Title

© 2026

Airscale · All rights reserved