# charlotte

charlotte hands your agent a compact, typed page structure instead of a full accessibility tree. Shows its worth when an agent browses often and burns tokens on noise.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 184 repo stars
- Author: TickTockBent
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TickTockBent/charlotte
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/charlotte

## What it does

Charlotte keeps a persistent headless Chromium session and turns each page into a structured view: landmarks, headings, interactive elements, forms, and content summaries. Three detail levels let the agent decide how much it receives.

On arrival, `navigate` returns a short orientation. For Hacker News that is 364 characters; a full snapshot from Playwright MCP runs around 50,000. When the agent needs more, it calls `observe` or `find` and pays only for the part it asked for. On content-heavy pages the orientation is 10–140x smaller than a full snapshot.

It ships 43 tools, but profiles keep startup light: the default `browse` profile carries about 49% less definition overhead than loading everything, and `core` cuts it by roughly 75%. The toolset covers navigation, observation, iframe-aware interaction, console and request monitoring, tabs, device emulation, network throttling, `dev_serve` with auto-reload, and `dev_audit` for a11y, performance, SEO, contrast, and broken links.

Node.js is required: the server runs through `npx`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add charlotte -- npx -y @ticktockbent/charlotte
```

### Codex

**Platform CLI**
```bash
codex mcp add charlotte -- npx -y @ticktockbent/charlotte
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "charlotte": {
            "command": "npx",
            "args": [
                "-y",
                "@ticktockbent/charlotte"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "charlotte": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ticktockbent/charlotte"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add charlotte npx -y @ticktockbent/charlotte
```

## When to use it
- cut token spend when an agent reads pages
- get page structure without a full accessibility tree
- locate one element with `find` instead of reading a whole snapshot
- take a screenshot and diff the structure against a snapshot
- check a page for a11y, SEO and broken links

## Example prompts
- Open Hacker News and list the first five headlines
- Find the login button with `find` and click it
- Fill the form on this page with data from `data.json`

## Similar
- [oculo](https://affpapa.org/en/nevibecode/mcp/oculo.md) — MCP server · ★ 5 repo stars
- [fortress](https://affpapa.org/en/nevibecode/mcp/fortress.md) — MCP server · ★ 818 repo stars
- [PageMap](https://affpapa.org/en/nevibecode/mcp/pagemap.md) — MCP server · ★ 36 repo stars
- [Kernel MCP Server](https://affpapa.org/en/nevibecode/mcp/kernel-mcp-server.md) — MCP server · ★ 40 repo stars
- [mcp](https://affpapa.org/en/nevibecode/mcp/kitewright-mcp.md) — MCP server · ★ 24 repo stars
- [CloakMCP](https://affpapa.org/en/nevibecode/mcp/cloakmcp.md) — MCP server · ★ 14 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
