# Airtop — how to use (mcp.ai)

Connect your Airtop account and use 10 tools for web scraping straight from your AI agent. Connect with your own API key. Airtop provides cloud browsers and AI-powered web automation for navigating sites, interacting with pages, extracting data, and running reusable browser workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_airtop?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `airtop_click_element`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/airtop`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/airtop/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/airtop/click/element` — Use Airtop AI to locate an element from a natural-language description and click it. This consumes Airtop credits and can trigger irreversible external effects such as submitting a form, placing an or
  - body: { window_id: string, click_type?: string, session_id: string, client_request_id?: string, element_description: string, wait_for_navigation?: boolean, cost_threshold_credits?: integer, time_threshold_seconds?: integer }
- `POST https://api.mcp.ai/api/airtop/close/window` — Close one browser window without terminating its Airtop session.
  - body: { window_id: string, session_id: string }
- `POST https://api.mcp.ai/api/airtop/create/session` — Create an Airtop browser session and wait until it is running. Sessions are billed in 30-second increments, so terminate them promptly when work is complete.
  - body: { proxy?: boolean|string|object|object[], record?: boolean, profile_name?: string, extension_ids?: string[], solve_captcha?: boolean, timeout_minutes?: integer, readiness_timeout_seconds?: integer }
- `POST https://api.mcp.ai/api/airtop/create/window` — Create a browser window in a running Airtop session and load an initial URL. If no URL is supplied, Airtop loads https://www.google.com.
  - body: { url?: string, session_id: string, wait_until?: string, screen_resolution?: string, wait_until_timeout_seconds?: integer }
- `POST https://api.mcp.ai/api/airtop/list/sessions` — List Airtop browser sessions, optionally filtering by IDs or status. Use this to discover sessions or check the current state of a known session.
  - body: { limit?: integer, status?: string, next_cursor?: string, session_ids?: string }
- `POST https://api.mcp.ai/api/airtop/list/windows` — List all browser windows in a running Airtop session, including their IDs, current URLs, and titles when available.
  - body: { session_id: string }
- `POST https://api.mcp.ai/api/airtop/navigate/window` — Navigate an existing Airtop browser window to a new URL and optionally wait for page loading.
  - body: { url: string, window_id: string, session_id: string, wait_until?: string, wait_until_timeout_seconds?: integer }
- `POST https://api.mcp.ai/api/airtop/query/page` — Ask Airtop AI a question about a page or extract structured page content. This operation consumes Airtop credits; the response reports credits_used, and cost/time thresholds cancel work after periodic
  - body: { prompt: string, window_id: string, session_id: string, output_schema?: object, client_request_id?: string, cost_threshold_credits?: integer, time_threshold_seconds?: integer, follow_pagination_links?: boolean, include_visual_analysis?: string }
- `POST https://api.mcp.ai/api/airtop/terminate/session` — Terminate an Airtop session and all of its windows. Use promptly after browser work to stop time-based session billing.
  - body: { session_id: string }
- `POST https://api.mcp.ai/api/airtop/type/text` — Use Airtop AI to locate an input and type text into it. This consumes Airtop credits. Enabling Enter can submit forms or trigger external effects, and the response preserves status, usage, warnings, a
  - body: { text: string, window_id: string, session_id: string, press_tab_key?: boolean, press_enter_key?: boolean, clear_input_field?: boolean, client_request_id?: string, element_description?: string, wait_for_navigation?: boolean, cost_threshold_credits?: integer, time_threshold_seconds?: integer }

## Example prompts
- "What can I do in Airtop?"
- "Show me a summary of my Airtop account"

## More
- Page: https://mcp.ai/airtop
- Agent spec (llms.txt): https://mcp.ai/airtop/llms.txt
- Postman collection: https://mcp.ai/airtop/postman.json