Can I use Airtop as a CLI?

Yes. KosmoKrator exposes a Airtop CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Airtop through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Airtop tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Airtop credentials stored?

Airtop credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Airtop MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

automation

Airtop CLI for AI Agents

Use the Airtop CLI from KosmoKrator to call Airtop tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

8 functions 5 read 3 write API key auth

Submit Airtop feedback View package source

Airtop CLI Setup

Airtop can be configured headlessly with `kosmokrator integrations:configure airtop`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure airtop --set api_key="$AIRTOP_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor airtop --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_key`	`AIRTOP_API_KEY`	Secret `secret`	yes	API Key
`url`	`AIRTOP_URL`	URL `url`	no	API Base URL

Call Airtop Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call airtop.airtop_create_session '{
  "profile": "example_profile",
  "proxy": "example_proxy"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:airtop airtop_create_session '{
  "profile": "example_profile",
  "proxy": "example_proxy"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs airtop --json
kosmo integrations:docs airtop.airtop_create_session --json
kosmo integrations:schema airtop.airtop_create_session --json
kosmo integrations:search "Airtop" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Airtop.

`airtop.airtop_create_session`

Write write

Create a new cloud browser session in Airtop. A session is a container for one or more browser windows. Returns the session ID needed to create windows and interact with pages.

Parameters: profile, proxy

Generic CLI call

kosmo integrations:call airtop.airtop_create_session '{"profile":"example_profile","proxy":"example_proxy"}' --json

Provider shortcut

kosmo integrations:airtop airtop_create_session '{"profile":"example_profile","proxy":"example_proxy"}' --json

`airtop.airtop_get_session`

Read read

Get details of an existing Airtop browser session, including its status and associated windows.

Parameters: session_id

Generic CLI call

kosmo integrations:call airtop.airtop_get_session '{"session_id":"example_session_id"}' --json

Provider shortcut

kosmo integrations:airtop airtop_get_session '{"session_id":"example_session_id"}' --json

`airtop.airtop_create_window`

Write write

Open a new browser window within an existing Airtop session. Optionally specify a starting URL to navigate to immediately.

Parameters: session_id, url, width, height

Generic CLI call

kosmo integrations:call airtop.airtop_create_window '{"session_id":"example_session_id","url":"example_url","width":1,"height":1}' --json

Provider shortcut

kosmo integrations:airtop airtop_create_window '{"session_id":"example_session_id","url":"example_url","width":1,"height":1}' --json

`airtop.airtop_get_window`

Read read

Get details of a browser window in an Airtop session, including its current URL and status.

Parameters: session_id, window_id

Generic CLI call

kosmo integrations:call airtop.airtop_get_window '{"session_id":"example_session_id","window_id":"example_window_id"}' --json

Provider shortcut

kosmo integrations:airtop airtop_get_window '{"session_id":"example_session_id","window_id":"example_window_id"}' --json

`airtop.airtop_navigate`

Write write

Navigate a browser window to a specified URL in an Airtop session. Waits for the page to load before returning.

Parameters: session_id, window_id, url, wait_until

Generic CLI call

kosmo integrations:call airtop.airtop_navigate '{"session_id":"example_session_id","window_id":"example_window_id","url":"example_url","wait_until":"example_wait_until"}' --json

Provider shortcut

kosmo integrations:airtop airtop_navigate '{"session_id":"example_session_id","window_id":"example_window_id","url":"example_url","wait_until":"example_wait_until"}' --json

`airtop.airtop_get_page_content`

Read read

Extract the content of the currently loaded page in an Airtop browser window. Returns the page text content, which can be used for analysis, summarization, or data extraction.

Parameters: session_id, window_id

Generic CLI call

kosmo integrations:call airtop.airtop_get_page_content '{"session_id":"example_session_id","window_id":"example_window_id"}' --json

Provider shortcut

kosmo integrations:airtop airtop_get_page_content '{"session_id":"example_session_id","window_id":"example_window_id"}' --json

`airtop.airtop_list_sessions`

Read read

List all active browser sessions in Airtop. Returns session IDs and their current status.

Parameters: none

Generic CLI call

kosmo integrations:call airtop.airtop_list_sessions '{}' --json

Provider shortcut

kosmo integrations:airtop airtop_list_sessions '{}' --json

`airtop.airtop_get_current_user`

Read read

Get the profile of the currently authenticated Airtop user. Useful for verifying API credentials and checking account details.

Parameters: none

Generic CLI call

kosmo integrations:call airtop.airtop_get_current_user '{}' --json

Provider shortcut

kosmo integrations:airtop airtop_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`airtop.airtop_create_session`

Create a new cloud browser session in Airtop. A session is a container for one or more browser windows. Returns the session ID needed to create windows and interact with pages.

Operation: Write write
Schema command: kosmo integrations:schema airtop.airtop_create_session --json

Parameter	Type	Required	Description
`profile`	string	no	Optional browser profile name to use for the session. Profiles can persist cookies and state across sessions.
`proxy`	string	no	Optional proxy configuration for the session (e.g., "http://user:pass@host:port").

`airtop.airtop_get_session`

Get details of an existing Airtop browser session, including its status and associated windows.

Operation: Read read
Schema command: kosmo integrations:schema airtop.airtop_get_session --json

Parameter	Type	Required	Description
`session_id`	string	yes	The ID of the session to retrieve.

`airtop.airtop_create_window`

Open a new browser window within an existing Airtop session. Optionally specify a starting URL to navigate to immediately.

Operation: Write write
Schema command: kosmo integrations:schema airtop.airtop_create_window --json

Parameter	Type	Required	Description
`session_id`	string	yes	The session ID to create the window in.
`url`	string	no	Optional starting URL to navigate to when the window opens.
`width`	integer	no	Window width in pixels (default: 1280).
`height`	integer	no	Window height in pixels (default: 720).

`airtop.airtop_get_window`

Get details of a browser window in an Airtop session, including its current URL and status.

Operation: Read read
Schema command: kosmo integrations:schema airtop.airtop_get_window --json

Parameter	Type	Required	Description
`session_id`	string	yes	The session ID.
`window_id`	string	yes	The window ID to retrieve.

`airtop.airtop_navigate`

Navigate a browser window to a specified URL in an Airtop session. Waits for the page to load before returning.

Operation: Write write
Schema command: kosmo integrations:schema airtop.airtop_navigate --json

Parameter	Type	Required	Description
`session_id`	string	yes	The session ID.
`window_id`	string	yes	The window ID to navigate.
`url`	string	yes	The URL to navigate to (e.g., "https://example.com").
`wait_until`	string	no	When to consider navigation complete: "load", "domcontentloaded", or "networkidle". Default is "load".

`airtop.airtop_get_page_content`

Extract the content of the currently loaded page in an Airtop browser window. Returns the page text content, which can be used for analysis, summarization, or data extraction.

Operation: Read read
Schema command: kosmo integrations:schema airtop.airtop_get_page_content --json

Parameter	Type	Required	Description
`session_id`	string	yes	The session ID.
`window_id`	string	yes	The window ID to get content from.

`airtop.airtop_list_sessions`

List all active browser sessions in Airtop. Returns session IDs and their current status.

Operation: Read read
Schema command: kosmo integrations:schema airtop.airtop_list_sessions --json

Parameter	Type	Required	Description
No parameters.

`airtop.airtop_get_current_user`

Get the profile of the currently authenticated Airtop user. Useful for verifying API credentials and checking account details.

Operation: Read read
Schema command: kosmo integrations:schema airtop.airtop_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.