> ## Documentation Index > Fetch the complete documentation index at: https://docs.airscale.io/llms.txt > Use this file to discover all available pages before exploring further. # Connect Airscale MCP to ChatGPT > Connect ChatGPT to Airscale through browser OAuth and validate the connection without spending credits. Connect ChatGPT to your Airscale workspace with browser OAuth, then verify the connection with a free tool call before you approve any paid work. ## MCP server URL Use the official remote MCP endpoint exactly as shown: ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} https://mcp.airscale.io/mcp ``` ## What ChatGPT can do with Airscale MCP Airscale MCP gives ChatGPT 42 typed tools that can: * Check the authorized workspace's credit balance. * Search for people and companies, including with Leads Finder filters. * Find companies similar to reference domains with Company lookalikes. * Count matches and discover accepted filter values before a paid search. * Enrich work contact details and extract people or company profiles. * Find a company's LinkedIn URL from its domain and list the people who liked or commented on a LinkedIn post. * Verify emails, check WhatsApp availability and US Do Not Call status, and look up a company's Meta ads. * Run Airsearch web research. * Create downloadable people or company exports. Managed large contact enrichment is work-email-only in its current phase. Review exact inputs and credit behavior in the [MCP tool catalog](https://docs.airscale.io/mcp/tools). ## Before you start You need an Airscale account with access to the intended workspace, API access enabled, and an active workspace credential. You also need a ChatGPT account and workspace where Developer mode is available; availability can depend on account and workspace policy. ChatGPT uses browser OAuth for this connection: if prompted, the browser asks you to sign in to Airscale, choose a workspace, and authorize ChatGPT. OpenAI's [current plugin connection guide](https://developers.openai.com/plugins/deploy/connect-chatgpt) is the source for the navigation below. After OAuth, Airscale's MCP server resolves the authorized workspace's current credential server-side on each tool call; ChatGPT neither receives nor stores that API key. Do not paste an Airscale API key into ChatGPT, prompts, or tool inputs. ## Step-by-step setup **1. Enable Developer mode** Open **Settings → Security and login**, then turn on **Developer mode**. Developer mode availability can depend on account and workspace policy. **2. Open ChatGPT Plugins** Go to **ChatGPT Plugins** and select the plus button. **3. Describe the connection** Enter a user-facing name and description, such as **Airscale MCP** and a short description of its search, enrichment, research, and export tools. **4. Connect and authorize Airscale** Under **Connection**, choose the public endpoint option and enter `https://mcp.airscale.io/mcp`, including the `/mcp` path. Create the connection. If prompted, complete browser OAuth, sign in to Airscale, select the intended workspace, and return to ChatGPT. Do not enter an API key or static authorization value. **5. Review discovered tools** Review the tools and metadata discovered from the server. Confirm that the Airscale connection shows the expected 42 typed tools before testing it. **6. Verify the connection for free** Start a new conversation, add the Airscale MCP connection from the tools menu, and run `airscale_check_credits` without another tool. A returned balance confirms tool discovery and authentication to an Airscale workspace without debiting credits, but it does not identify which workspace. Separately verify the workspace shown during OAuth before paid actions. ## Recommended first prompts The identities and domains below are synthetic. > Use `airscale_check_credits` to show my current Airscale credit balance. Do not call another tool. This is the free connection test. A returned balance confirms tool discovery and authentication to an Airscale workspace without debiting credits. It does not identify which workspace; verify the workspace shown during OAuth before paid actions. > Count people named Jordan Example who work at `northstar.example`. Do not run a paid search. > Plan an Airscale search for up to five companies matching `sample-company.test`. Show the proposed Airscale tool, arguments, and maximum cost, then wait for my approval. For a complete staged sequence, follow the [safe MCP workflow](https://docs.airscale.io/mcp/how-to-use-the-airscale-mcp.md). ## Export behavior in ChatGPT A people or company export performs a fresh paid search from the final filters; it does not package the selected chat rows and may return different rows. Before approval, review the exact filters, fields, format, `max_rows`, additional maximum credits, and cumulative workflow maximum. An export has one asynchronous lifecycle: start the export once, check its status, then retrieve the file when it is ready. Reuse the same `export_id` and honor the returned `poll_after_seconds`. Do not start a duplicate export while the original job is queued or running. ## Credits and confirmation The credit check, people count, company filter-value discovery, export status, and export-file retrieval are free. Search and enrichment tools can consume credits; Airsearch costs 1 credit per successful call. Managed contact enrichment is work-email-only in its current phase. Paid export starts fail closed until `confirm_credit_spend` is explicitly `true`. Review ChatGPT's proposed tool, arguments, row limit, and maximum cost before confirming. An export can support up to 10,000 rows, but use the smallest limit that serves the task. ## Refreshing tools If Airscale tools or metadata are stale, open the connection in **ChatGPT Plugins**, select **Refresh**, confirm the advertised metadata changed, then start a new conversation and add the connection again from the tools menu. ## Troubleshooting > **Developer mode is not visible** > > Open **Settings → Security and login** and look for **Developer mode**. Availability can depend on account and workspace policy, so ask the workspace administrator to check policy if the control is unavailable. > **The connection cannot be created** > > Confirm the exact public endpoint, including the `/mcp` path. Complete Airscale browser authorization if prompted, return to ChatGPT, and review any connection or discovered-tool errors before retrying. > **Authentication succeeds but a tool fails** > > Confirm that the selected Airscale workspace has API access, an active workspace credential, and enough credits for the proposed paid tool. Run `airscale_check_credits` before retrying. > **An export remains queued** > > Poll `airscale_get_export_status` with the same identifier and the returned `poll_after_seconds`. Do not create another paid job. ## Security note Authorize only the Airscale workspace you intend to use. Keep secrets out of chats and tool inputs, review every proposed paid action, and remove the Airscale MCP connection when it is no longer needed. ## Need help? * Review the [MCP tool catalog](https://docs.airscale.io/mcp/tools) for exact schemas and credit behavior. * Use the [safe MCP workflow](https://docs.airscale.io/mcp/how-to-use-the-airscale-mcp.md) before running a search or export. * Read the [Airscale MCP server overview](https://docs.airscale.io/mcp/airscale-mcp-server.md) for authentication and security guidance. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.