MCP and agents

Connect Airscale MCP to Claude

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

Add Airscale MCP to Claude

Use Airscale MCP to let ChatGPT, Claude, or another MCP-compatible assistant search, enrich, and export Airscale data directly from a conversation.

MCP Server

Use this remote MCP server URL:

https://mcp.airscale.io/mcp

This is the official Airscale MCP endpoint. When ChatGPT, Claude, or another MCP client asks for a remote MCP server URL, paste this exact URL.

Airscale MCP uses OAuth in supported hosted clients, so users normally do not paste Airscale API keys into ChatGPT or Claude. The selected Airscale workspace still needs API access enabled and an active Airscale API key, because OAuth resolves that workspace API key behind the scenes when tools run.

Important access notes

  • For Claude Team and Enterprise accounts, an Owner or Primary Owner must add Airscale MCP to the organization before members can connect it. After the organization adds the connector, each member still connects and authenticates with their own Airscale account.

  • For ChatGPT Enterprise, Business, Education, Pro, and Plus accounts, custom MCP apps are available on the web through Developer Mode. If the UI differs, look for Apps, Advanced settings, Developer Mode, Custom MCP, or Create app.

  • If OAuth succeeds but Airscale tools fail with an authentication or credits error, check the Airscale workspace first: API access must be enabled and the workspace must have an active API key.

What Airscale MCP can do

When enabled in a conversation, Airscale MCP 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 supported ChatGPT or Claude account.

  • Web access to the AI assistant you want to connect.

You do not need to manually pass an Airscale API key to ChatGPT or Claude when using OAuth.

ChatGPT setup

  1. Open ChatGPT on the web and sign in.

  2. Open Settings from your profile or workspace menu.

  3. Go to Apps.

  4. Open Advanced settings.

  5. Enable Developer mode.

  6. Click Create app next to Advanced settings.

  7. Enter the name Airscale MCP.

  8. Enter the MCP server URL https://mcp.airscale.io/mcp.

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

  10. Confirm that you trust the third-party MCP server.

  11. Create the app.

  12. Complete the Airscale OAuth flow in the browser.

  13. Return to ChatGPT.

  14. Open a new conversation.

  15. Choose Developer mode from the plus menu.

  16. Select Airscale MCP and confirm it is active in the chat.

Test the connection with:

Check my Airscale credits

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

Claude setup

Individual Claude accounts

  1. Open Claude on the web and sign in.

  2. Go to Customize > Connectors.

  3. Click +.

  4. Choose Add custom connector.

  5. Enter the name Airscale MCP.

  6. Enter the remote MCP server URL https://mcp.airscale.io/mcp.

  7. Add the connector.

  8. Complete the Airscale OAuth flow.

Test the connection with:

Check my Airscale credits

Claude Team and Enterprise accounts

For Claude Team and Enterprise, the organization must approve the connector first.

An Owner or Primary Owner should:

  1. Open Claude Organization settings.

  2. Go to Connectors.

  3. Click Add.

  4. Choose Custom > Web.

  5. Enter the remote MCP server URL:

    https://mcp.airscale.io/mcp

  6. Finish adding Airscale MCP to the organization.

Then each member should:

  1. Go to Customize > Connectors.

  2. Find Airscale MCP.

  3. Click Connect.

  4. Authenticate with their own Airscale account.

  5. Test with:

    Check my Airscale credits

The organization approval step only makes Airscale MCP available in Claude. It does not make every member share the same Airscale session.

Refreshing tools

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

  1. Open the app or connector settings.

  2. Select Airscale MCP.

  3. Click Refresh if available.

  4. If refresh is not available, remove and recreate the custom app or connector.

  5. Start a new chat and select Airscale MCP again.

Example requests

Search people:

Find marketing directors at software companies in the US

Search companies:

Find fintech companies in the UK with 11 to 50 employees

Discover filter values:

Show me accepted Find Companies industry values for "software"

Enrich contacts:

Find professional emails for these LinkedIn profiles

Export people or companies:

Export up to 10,000 matching people as

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

Export behavior

Airscale exports are asynchronous jobs. The expected flow is:

  1. The assistant starts the export and receives an export_id.

  2. The assistant polls airscale_get_export_status.

  3. The assistant shows status_message, progress_message, and credit fields.

  4. When status is completed, the assistant calls airscale_get_export_file.

  5. The assistant 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 duplicate export can create another paid job.

Use this prompt if the assistant seems stuck:

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:

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 }

The assistant should show the estimated maximum before starting and actual credits as the job runs.

Troubleshooting

I do not see Apps, Connectors, or Developer Mode

Make sure you are using the web version of ChatGPT or Claude with a supported account.

For Claude Team or Enterprise, ask an Owner or Primary Owner to add Airscale MCP in Organization settings > Connectors before trying to connect it yourself.

For ChatGPT, make sure Developer Mode is enabled in Settings > Apps > Advanced settings.

Claude says I cannot add the connector

On Claude Team and Enterprise plans, individual members usually cannot add custom remote MCP connectors directly. Ask an Owner or Primary Owner to add Airscale MCP to the organization with this URL:

https://mcp.airscale.io/mcp

After that, connect it from Customize > Connectors and authenticate with Airscale.

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 or Claude cannot find Airscale tools

Refresh Airscale MCP from the app or connector settings. If that does not work, remove and recreate the custom app or connector, then start a new chat.

The assistant 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.

An export is queued for a while

This can be normal for large exports. Keep polling the same export_id and follow poll_after_seconds. Do not start a duplicate export unless you intentionally want a second paid job.

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 supported hosted clients 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