FlashID MCP Server

Connect AI agents to FlashID. The flashid-mcp package is a Model Context Protocol server that lets Claude Code, Codex, Claude Desktop, Cursor and any other MCP client manage your profiles, tags, proxies and folders, and open browsers with automation endpoints — all through natural language, on top of the Local API.

Requirements

• FlashID desktop app installed and running, with Local API enabled (FlashID → Settings → Local API)
• Your API key (FlashID → Settings → API Access)
• Node.js ≥ 18 (npx comes with it)

Setup

Claude Code

claude mcp add flashid -e FLASHID_API_KEY=your-api-key -- npx -y flashid-mcp

Codex

codex mcp add flashid --env FLASHID_API_KEY=your-api-key -- npx -y flashid-mcp

Claude Desktop / Cursor

Add to your MCP configuration file (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "flashid": {
      "command": "npx",
      "args": ["-y", "flashid-mcp"],
      "env": { "FLASHID_API_KEY": "your-api-key" }
    }
  }
}

Environment variables

Tools

Try it

Create a tag named ecommerce, create 3 Windows 11 profiles named shop-1..3 with that tag, bind my proxy 1.2.3.4:1080 to them, and open the first one.

create_profile only requires system — omitted fingerprint fields are auto-generated as a coherent random fingerprint. Pass tag_uuids to create_profile or update_profile to set all profile tags at once, or use attach_profile_tag and detach_profile_tag to change one association.

Page automation

open_browser returns automation endpoints for the launched browser:

{
  "id": "…",
  "ws": {
    "puppeteer": "ws://127.0.0.1:9222/devtools/browser/…",
    "selenium": "127.0.0.1:9222"
  },
  "debug_port": 9222
}

Hand ws.puppeteer to Playwright / Puppeteer (puppeteer.connect({ browserWSEndpoint })) or to a browser-automation MCP server to drive pages inside the fingerprinted browser.