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 Headless Automation

Use the Airtop CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

8 functions 5 read 3 write API key auth

Submit Airtop feedback View package source

Airtop CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Airtop CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Airtop CLI for Headless Automation
kosmokrator integrations:configure airtop --set api_key="$AIRTOP_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call airtop.airtop_create_session '{"profile":"example_profile","proxy":"example_proxy"}' --json

Discovery Before Execution

Agents and scripts can inspect Airtop docs and schemas 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

Useful Airtop CLI Functions

Function	Type	Parameters	Description
`airtop.airtop_create_session`	Write	profile, proxy	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.
`airtop.airtop_get_session`	Read	session_id	Get details of an existing Airtop browser session, including its status and associated windows.
`airtop.airtop_create_window`	Write	session_id, url, width, height	Open a new browser window within an existing Airtop session. Optionally specify a starting URL to navigate to immediately.
`airtop.airtop_get_window`	Read	session_id, window_id	Get details of a browser window in an Airtop session, including its current URL and status.
`airtop.airtop_navigate`	Write	session_id, window_id, url, wait_until	Navigate a browser window to a specified URL in an Airtop session. Waits for the page to load before returning.
`airtop.airtop_get_page_content`	Read	session_id, window_id	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.
`airtop.airtop_list_sessions`	Read	none	List all active browser sessions in Airtop. Returns session IDs and their current status.
`airtop.airtop_get_current_user`	Read	none	Get the profile of the currently authenticated Airtop user. Useful for verifying API credentials and checking account details.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Airtop CLI Pages

CI Airtop CLI for CI. Cron Jobs Airtop CLI for cron jobs. Shell Scripts Airtop CLI for shell scripts. Coding Agents Airtop CLI for coding agents.