mcp-sakana-chat

MCP server that drives chat.sakana.ai via headless Chrome — persistent sessions for AI assistant use.

Installation

Via npx (recommended — no install needed)

npx background-ai-chat

Via npm global install

npm install -g background-ai-chat
background-ai-chat

From source (for development)

git clone https://github.com/misternay/mcp-sakana-chat.git
cd mcp-sakana-chat
npm install && npm run build && npm start

Related MCP server: Chrome MCP Server

Claude Desktop Config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or equivalent:

{
  "mcpServers": {
    "sakana-chat": {
      "command": "npx",
      "args": ["-y", "background-ai-chat"]
    }
  }
}

Why -y flag: Skips npm's install confirmation prompt, required for non-interactive usage.

Alternative (if globally installed):

{
  "mcpServers": {
    "sakana-chat": {
      "command": "background-ai-chat"
    }
  }
}

Environment Variables

MCP Tools

• session_open — Open a persistent chat session. Input: { login?, headless?, tosAccepted? } → Output: { sessionId, conversationId, mode, rateLimit, tosSummary }

• chat_send — Send a message with streaming token events. Input: { sessionId, message } → Output: { reply, tokens[] }

• chat_interrupt — Abort an in-flight message. Input: { sessionId } → Output: { interrupted: true }

• session_close — Close a session and release its browser. Input: { sessionId, keepHistory? } → Output: { closed, messagesExchanged }

• session_list — List all known sessions. Input: {} → Output: { sessions[] }

First call requires tosAccepted: true. Subsequent calls reuse the machine-wide ack.

Guardrails

• ToS gate — machine-wide acknowledgment of Sakana Terms 5.8/5.9

• Cookie isolation — separate browser context per session

• No message logging — only metadata (sessionId, event, ms) to stderr

• Personal/internal use only — not a competing product

Development

npm run build       # compile TypeScript
npm test            # run tests
npm run test:watch  # watch mode