Connect Airscale MCP to ChatGPT

Step-by-step guide to adding Airscale MCP to Claude 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 Claude directly to your Airscale workspace.

When enabled in a conversation, Claude can:

• Check your Airscale credits

• Search for people and companies

• Discover 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

Authentication is handled through OAuth for Claude connectors. You sign in once with Airscale, and Claude stores the connection securely. No API keys need to be pasted into Claude.

Before you start

Make sure you have:

• An Airscale account

• Access to an Airscale workspace with API access

• Claude, Claude Desktop, or a Claude workspace where custom connectors are available. Custom connectors are available on free, Pro, Max, Team, and Enterprise plans; free users are limited to one custom connector.

• Claude web or desktop access

Step-by-step setup

Step 1: Open Claude settings

Go to Claude and sign in.

Open your profile or account menu, then go to the settings area where connectors are managed.

The exact label can vary by Claude workspace, but look for Connectors, Custom connectors, or Add connector.

Step 2: Add a custom connector

Choose the option to add a custom connector.

Enter:

Name: Airscale
Remote MCP server URL: https://mcp.airscale.io/mcp

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

Click Add.

Step 3: Authenticate with Airscale

Claude opens a browser window.

Sign in with your Airscale account, choose the workspace you want to connect, and authorize access.

After you see the confirmation page, close the browser tab and return to Claude.

Step 4: Enable Airscale in a chat

Open a new Claude conversation.

Use the connector picker in the chat input, then enable Airscale.

Some Claude workspaces require enabling the connector in every new conversation.

Step 5: Test the connection

Ask:

Check my Airscale credits

If Claude returns your credit balance, setup is complete.

For team workspaces

If your Claude workspace manages connectors at the organization level, an Owner or Primary Owner may need to enable or add Airscale first.

Admin setup:

1. Open organization settings.

2. Go to connectors.

3. Add a custom web or remote MCP connector.

4. Paste:

https://mcp.airscale.io/mcp

After the connector is available to the organization, each user still needs to connect and authenticate their own Airscale account.

What you can do next

Search people

Find Heads of Growth at B2B SaaS companies in the United States

Search companies

Find cybersecurity companies in France with 51 to 200 employees

Enrich contacts

Find professional emails for these LinkedIn profiles

Export results

Export up to 2,000 matching companies as

Claude should start an export job, poll status, and return a download URL when the file is ready.

Export behavior in Claude

Airscale export tools are asynchronous. Claude should not try to paginate thousands of rows through chat.

The expected flow is:

1. Claude starts an export and receives an export_id.

2. Claude polls airscale_get_export_status.

3. Claude shows status_message and progress_message.

4. When status is completed, Claude calls airscale_get_export_file.

5. Claude returns the download URL or resource link.

Large exports can take several minutes. If Claude sees queued and 0 rows, it should show the status_message and poll again after poll_after_seconds.

Credits and confirmation

Claude may ask for approval before tool calls depending on your Claude settings.

Airscale also requires explicit credit confirmation for export jobs. Export start tools must include confirm_credit_spend: true.

Exports show:

• estimated_max_credits before the job runs

• actual_credits as rows are written

Free tools include:

• airscale_check_credits

• airscale_count_find_people

• airscale_find_companies_filter_values

Search, enrichment, Airsearch, and exports follow Airscale API credit pricing.

Troubleshooting

I do not see the Connectors option

Custom connectors may not be enabled for your Claude plan, workspace, or region. Check your Claude plan and workspace settings.

The authentication window opened but nothing happens

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

Claude cannot find Airscale tools

Make sure Airscale is enabled in the current chat.

If Claude still shows an old tool list, refresh or reconnect the connector. Tool discovery is cached by some clients at the start of a conversation.

The current Airscale MCP tool set includes 19 tools: 15 core public API tools and 4 export tools.

Claude says an export is queued for a while

This can be normal for large exports. Ask Claude to keep polling with:

Use airscale_get_export_status for this export_id and follow poll_after_seconds

Once the export is completed, ask:

Get the export file for this export_id

Claude tries to fetch thousands of rows manually

Ask Claude to use the export tools instead:

Do not paginate results through chat. Start an Airscale export job and give me the CSV download link when it is ready

Need help?

Contact Airscale support from your Airscale workspace.