Airtop MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Airtop's browser automation service.

Installation

TODO: publish to npm

npm install

Usage

Development

1. Clone the repository
2. Install dependencies:

   npm install

3. Set your Airtop API key:

   export AIRTOP_API_KEY=your_api_key_here

4. Start the development server:

   npm run dev -- --server

Use in Claude (Native MacOS)

Go into the Claude app, open up Settings -> Developer -> Edit Config

Add the following: (replace <airtop-mcp-path> with the path to the airtop-mcp repository)

{
  "mcpServers": {
    "airtop": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "tsx@latest",
        "-c",
        "cd <airtop-mcp-path> && tsx src/server.ts"
      ]
    }
  }
}

Available Tools

• createSession: Create a new Airtop browser session
• createWindow: Create a new browser window in the session
• pageQuery: Query the current page content using AI
• terminateSession: Terminate an Airtop browser session
• paginatedExtraction: Extract data from a paginated list

Configuration

The server runs on port 3456 by default. You can change this by setting the PORT environment variable.

License

ISC