H tspot Docs
Hotspot › Docs › AI & Self-Hosting › AI & MCP Server

Model Context Protocol (MCP) & AI Agents

Connect Hotspot directly to Claude Code, Cursor, Antigravity, and Codex using the native Model Context Protocol (MCP) server.

Hotspot includes a native Model Context Protocol (MCP) server, allowing AI coding assistants (like Claude Code, Cursor, and Antigravity) to query your live telemetry, inspect session replays, and analyze drop-offs directly in your IDE.

MCP Endpoints

  • Streamable HTTP MCP: https://hotspot.buxa.ai/mcp (Modern standard)
  • Legacy Server-Sent Events (SSE): https://hotspot.buxa.ai/mcp/sse
  • Downloadable Skill: https://hotspot.buxa.ai/skill.md

Claude Desktop & Claude Code Configuration

Add Hotspot to your claude_desktop_config.json:

JSON
{
  "mcpServers": {
    "hotspot": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch", "https://hotspot.buxa.ai/mcp"],
      "headers": {
        "Authorization": "Bearer YOUR_HOTSPOT_SECRET_KEY"
      }
    }
  }
}

Cursor Configuration

Add to .cursor/mcp.json in your project workspace:

JSON
{
  "mcpServers": {
    "hotspot": {
      "url": "https://hotspot.buxa.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_HOTSPOT_SECRET_KEY"
      }
    }
  }
}

Instant Browser Connect (Device Flow)

To authorize an AI tool without exposing raw passwords, visit https://hotspot.buxa.ai/connect/. Enter the 8-character device code displayed in your terminal, select which website to authorize, and approve access in one click.