izan.io

What is izan.io?

izan.io is a Chrome extension that turns your browser into an MCP server. Any MCP client - Claude Desktop, Cursor, VS Code, Claude Code - can connect and control your browser through tools.

• Write tools in JavaScript using the browser API (click, type, navigate, extract data)

• Install tools from the zihin.io community marketplace

• Your sessions stay yours - the extension runs inside your authenticated browser, no cookie hacks needed

Quick Start

1. Install the Chrome Extension from the Chrome Web Store.

2. Add to your MCP client config:

{
  "mcpServers": {
    "izan": {
      "command": "npx",
      "args": ["izan-mcp"]
    }
  }
}

Works with Claude Desktop, Cursor, VS Code, Claude Code, and any MCP client that supports stdio.

3. Done. The extension connects automatically. Built-in tools (web_fetch, accessibility_snapshot) are ready to use. Open the side panel to create your own tools or install from the marketplace.

Architecture

MCP Client (Claude Desktop, Cursor, VS Code)
  | stdio (JSON-RPC)
  v
packages/bridge/  (izan-mcp CLI)
  | WebSocket (localhost:3717)
  v
Chrome Extension (packages/extension/)
  | CDP (chrome.debugger)
  v
Browser Tab (any website)

izan.io/
├── apps/
│   ├── web/              # Landing page + docs (izan.io)
│   └── zihin.io/         # Tool marketplace (zihin.io)
├── packages/
│   ├── extension/        # Chrome extension (MCP server, side panel, CDP automation)
│   └── bridge/           # Bridge CLI (stdio <-> WebSocket)

Writing Tools

Tools are JavaScript async functions with a browser API:

async (params, browser) => {
  await browser.open(`https://example.com/search?q=${params.query}`)
  await browser.waitForSelector('.result')
  const title = await browser.getText('.result:first-child .title')
  await browser.close()
  return { title }
}

Create tools in the extension side panel or submit to the zihin.io marketplace.

Development

git clone https://github.com/ekingunoncu/izan.io.git
cd izan.io
npm install
npm run build

Load packages/extension/dist as an unpacked extension in Chrome (chrome://extensions, developer mode).

License

AGPL-3.0 - See LICENSE.