FireKey MCP Server

MCP server for FireKey browser profile management. Allows AI tools like Claude Desktop, Cursor, and Claude Code to manage browser profiles through natural language.

Prerequisites

• FireKey desktop app running with Local API enabled (Settings → Local API)
• Node.js 18+

Quick Start

npx firekey-mcp --api-key YOUR_API_KEY

Configuration

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "firekey": {
      "command": "npx",
      "args": ["-y", "firekey-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "firekey": {
      "command": "npx",
      "args": ["-y", "firekey-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Cursor

Add to MCP settings:

{
  "mcpServers": {
    "firekey": {
      "command": "npx",
      "args": ["-y", "firekey-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Options

| Option | Env Variable | Description | Default | |--------|-------------|-------------|---------| | --port | FIREKEY_PORT | FireKey Local API port | Auto-detect | | --api-key | FIREKEY_API_KEY | API key for authentication | — |

Port is auto-discovered from FireKey's data directory. Manual override only needed if running multiple instances.

Available Tools

Browser Management

• browser_start — Start a browser profile, returns WebSocket endpoints for Puppeteer/Selenium
• browser_stop — Stop a running browser
• browser_active — List currently running browsers

Profile Management

• profile_list — List profiles with filtering and pagination
• profile_create — Create a new profile with fingerprint/proxy settings
• profile_update — Update profile settings
• profile_delete — Delete profiles (soft delete)
• profile_move — Move profiles to a group
• profile_delete_cache — Clear profile cache (cookies, history, etc.)
• profile_cookies — Get cookies from a profile

Group Management

• group_list — List profile groups
• group_create — Create a new group
• group_update — Update a group

Proxy Management

• proxy_list — List saved proxies
• proxy_create — Create a new proxy

Example Usage

Once configured, you can use natural language in Claude:

• "List all my browser profiles"
• "Create a Windows profile with Chrome 143 and random fingerprint"
• "Start the first profile and give me the Puppeteer WebSocket URL"
• "Stop all running browsers"
• "Create a group called 'Amazon' and move profile #1 into it"

Development

cd mcp-server
npm install
npm run build
node dist/index.js --api-key YOUR_KEY