Skip to main content
Glama

Charlotte

Web を、読みやすく。

あなたの AI エージェントは、Hacker News のトップページを見るだけで、アクセシビリティツリーを約 50,000 文字消費します。Charlotte なら 364 文字です。

Charlotte は、AI エージェントに構造化されたトークン効率の良い Web アクセスを提供する MCP サーバーです。 毎回アクセシビリティツリー全体をダンプする代わりに、Charlotte はエージェントが必要とするものだけを返します。到着時のコンパクトなページ概要、特定要素のターゲットクエリ、そして明示的に要求された場合のみ完全な詳細です。コンテンツ量の多いページでは、そのオリエンテーションは Playwright MCP の完全なアクセシビリティツリースナップショットよりも最大約 140 倍小さくなります。ごく小さなページでは、両者はほぼ同じサイズです。

なぜ Charlotte なのか?

ほとんどのブラウザ MCP サーバーは、毎回アクセシビリティツリー全体をダンプします。これは、コンテンツ量の多いページでは 100 万文字を超えることもあるフラットなテキストブロックです。エージェントは、必要かどうかに関係なく、そのすべてを支払います。

Charlotte は各ページを型付きの構造化表現(ランドマーク、見出し、インタラクティブ要素、フォーム、コンテンツ概要)に分解し、エージェントが 3 つの詳細レベルで受け取る量を制御できるようにします。エージェントが新しいページに移動すると、完全な要素ダンプ(約 50,000 文字)の代わりにコンパクトなオリエンテーション(Hacker News では 364 文字)を受け取ります。具体的な情報が必要な場合は、それを要求します。

ベンチマーク

Charlotte v0.8.0 を Playwright MCP v0.0.79 に対して、実際の Web サイトでのツール呼び出しごとの返却文字数で測定(npx tsx benchmarks/run-benchmarks.ts --suite comparison)、2026-08-08。このセクションは概要です。正規のベンチマークページ(タスクごとのコストとリリースドリフトを含む)は charlotte.mintlify.site/benchmarks にあります。方法論、計測器、生の結果は benchmarks/ にあります。

オリエンテーションコスト(エージェントがページを「見る」ために支払うコスト):

Charlotte の navigate はデフォルトで使用可能なオリエンテーション(ランドマーク、見出し、ページ領域ごとのインタラクティブ要素数)を返します。Playwright MCP で同等のものを得るには、エージェントは browser_snapshot を呼び出す必要があり、これは完全なアクセシビリティツリーを返します。(Playwright の browser_navigate 単独では短い確認のみを返し、ページコンテンツは返さないため、同等の比較にはなりません。)

サイト

Charlotte navigate

Playwright browser_snapshot

小さい倍率

example.com

415

465

1.1x

httpbin form

619

1,847

3.0x

GitHub repo

3,778

38,983

10x

Wikipedia (AI article)

22,134

1,137,928

51x

Hacker News

364

50,706

139x

この利点はページの複雑さに応じて拡大します。コンテンツ量の多いページでは、構造化オリエンテーションは完全なスナップショットよりも 約 10〜140 倍小さく、example.com のようなごく小さなページでは両者は約 20% 以内の差です(そして、そのような小さなページでは、構造化表現の方が大きくなることもあります。要約するものが単にないからです)。Charlotte の価値は、Playwright のフラットなダンプが最も痛い場所で正確に発揮されます。エージェントがオリエンテーション以上のものを必要とする場合、ツリー全体を前払いする代わりに、必要な部分だけを observe または find で呼び出します。

ツール定義のオーバーヘッド(API 呼び出しごとの目に見えないコスト):

プロファイル

ツール

定義トークン/呼び出し

フルとの比較での削減

full

43

8,500

—

browse (デフォルト)

23

4,372

約 49%

core

7

2,186

約 75%

ツール定義は API の往復ごとに送信されます。デフォルトの browse プロファイルでは、Charlotte は 43 個すべてのツールをロードする場合よりも約 49% 少ない定義オーバーヘッドを運びます。最小限の core プロファイルでは約 75% 削減されます。完全な結果は プロファイルベンチマークレポート を参照してください。

ワークフローの違い: 完全なスナップショットを読む Playwright エージェントは、見出しを読む場合でもログインボタンを探す場合でも、Hacker News を見るたびに約 50,000 文字を受け取ります。Charlotte エージェントは到着時に 364 文字を受け取り、find({ type: "link", text: "login" }) を呼び出して必要なものだけを正確に取得し、残りの部分に対して支払うことはありません。

Related MCP server: stealth-agent-browser-mcp

仕組み

Charlotte は永続的なヘッドレス Chromium セッションを維持し、視覚的な Web とエージェントのテキストネイティブな推論の間の変換レイヤーとして機能します。すべてのページは構造化表現に分解されます:

┌─────────────┐     MCP Protocol     ┌──────────────────┐
│   AI Agent  │<────────────────────>│    Charlotte     │
└─────────────┘                      │                  │
                                     │  ┌────────────┐  │
                                     │  │  Renderer  │  │
                                     │  │  Pipeline  │  │
                                     │  └─────┬──────┘  │
                                     │        │         │
                                     │  ┌─────▼──────┐  │
                                     │  │  Headless  │  │
                                     │  │  Chromium  │  │
                                     │  └────────────┘  │
                                     └──────────────────┘

エージェントは、ランドマーク、見出し、型付きメタデータを持つインタラクティブ要素、バウンディングボックス、フォーム構造、コンテンツ概要を受け取ります。これらはすべて、ブラウザがすべてのページについてすでに知っている情報から導き出されます。

機能

ナビゲーション — navigate、back、forward、reload

観察 — observe(3 つの詳細レベル、構造ツリービュー)、find(空間 + セマンティック検索、CSS セレクターモード、大きな結果セット用の output_file)、screenshot(永続的なアーティファクト管理付き)、screenshots、screenshot_get、screenshot_delete、diff(スナップショットとの構造比較)

インタラクション(iframe 対応)— click、click_at(座標ベース)、type(スロータイピングサポート付き)、select、toggle、submit、scroll、hover、drag、key(要素ターゲティング付きの単一/シーケンス)、wait_for(非同期条件ポーリング)、upload(ファイル入力)、fill_form(バッチフォーム入力)、dialog(JS ダイアログの受け入れ/拒否)

モニタリング — console(すべての重大度レベル、フィルタリング、タイムスタンプ)、requests(完全な HTTP 履歴、メソッド/ステータス/リソースタイプのフィルタリング)

セッション管理 — tabs、tab_open、tab_switch、tab_close、viewport(汎用プリセットまたは「iPhone 15」などの名前付きデバイス。DPR、タッチ、ユーザーエージェントエミュレーション付き)、network(スロットリング、URL ブロッキング)、set_cookies、get_cookies、clear_cookies、set_headers、configure

開発モード — dev_serve(静的サーバー + 自動リロード付きファイルウォッチ)、dev_inject(CSS/JS インジェクション)、dev_audit(a11y、パフォーマンス、SEO、コントラスト、壊れたリンク)

ユーティリティ — evaluate(ページコンテキストでの任意の JS 実行)

ツールプロファイル

Charlotte には 43 個のツール(42 個の登録済み + charlotte_tools メタツール)が含まれていますが、ほとんどのワークフローはサブセットのみを必要とします。起動プロファイルは、エージェントのコンテキストにロードするツールを制御し、定義オーバーヘッドを最大約 75% 削減します。

charlotte --profile browse    # 23 tools (default) — navigate, observe, interact, tabs
charlotte --profile core      # 7 tools — navigate, observe, find, click, type, submit
charlotte --profile full      # 43 tools — everything
charlotte --profile interact  # 31 tools — full interaction + dialog + evaluate
charlotte --profile develop   # 34 tools — interact + dev_serve, dev_inject, dev_audit
charlotte --profile audit     # 14 tools — navigation + observation + dev_audit + viewport

エージェントは、再起動せずにセッション中にさらにツールをアクティブ化できます:

charlotte_tools enable dev_mode    → activates dev_serve, dev_audit, dev_inject
charlotte_tools disable dev_mode   → deactivates them
charlotte_tools list               → see what's loaded

セルフホスティング(Charlotte Remote)

Charlotte をリモート MCP サーバーとして実行し、claude.ai に接続します。1 つのコマンドで:

docker run --cap-add SYS_ADMIN --shm-size 2g -p 3737:3737 ghcr.io/ticktockbent/charlotte

公開コネクタ URL とオペレータートークンが出力されます。claude.ai で: 設定 → コネクタ → カスタムコネクタを追加 — URL を貼り付け、OAuth クライアント ID/シークレットフィールドは空白のままにし、Charlotte の同意ページが表示されたらトークンを入力します。これで完了です。ブラウジングできます。

デモ URL とトークンは一時的なものです(両方とも再起動時にローテーションされます)。実際に運用する場合(安定したドメイン、独自のトンネルまたはリバースプロキシ、docker compose)は、セルフホスティング を参照してください。信頼モデルとネットワークガードは セキュリティ にあります。コンテナとサンドボックスの内部は Docker にあります。

クイックスタート

前提条件

  • Node.js >= 20

  • npm

インストール

Charlotte は MCP レジストリ に io.github.TickTockBent/charlotte として登録されており、npm に @ticktockbent/charlotte として公開されています:

npm install -g @ticktockbent/charlotte

Docker イメージは Docker Hub と GitHub Container Registry で利用できます:

# Alpine (default, smaller)
docker pull ticktockbent/charlotte:alpine

# Debian (if you need glibc compatibility)
docker pull ticktockbent/charlotte:debian

# Or from GHCR
docker pull ghcr.io/ticktockbent/charlotte:latest

またはソースからインストール:

git clone https://github.com/ticktockbent/charlotte.git
cd charlotte
npm install
npm run build

実行

Charlotte は MCP プロトコルを使用して stdio 経由で通信します:

# If installed globally (default browse profile)
charlotte

# With a specific profile
charlotte --profile core

# If installed from source
npm start

MCP クライアント設定

Claude Code

プロジェクトルートに .mcp.json を作成します:

{
  "mcpServers": {
    "charlotte": {
      "type": "stdio",
      "command": "npx",
      "args": ["@ticktockbent/charlotte"],
      "env": {}
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "charlotte": {
      "command": "npx",
      "args": ["@ticktockbent/charlotte"]
    }
  }
}

Cursor

.cursor/mcp.json に追加:

{
  "mcpServers": {
    "charlotte": {
      "command": "npx",
      "args": ["@ticktockbent/charlotte"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加:

{
  "mcpServers": {
    "charlotte": {
      "command": "npx",
      "args": ["@ticktockbent/charlotte"]
    }
  }
}

VS Code (Copilot)

.vscode/mcp.json に追加:

{
  "servers": {
    "charlotte": {
      "type": "stdio",
      "command": "npx",
      "args": ["@ticktockbent/charlotte"]
    }
  }
}

Cline

Cline MCP 設定に追加(Cline サイドバー > MCP サーバー > 設定 から):

{
  "mcpServers": {
    "charlotte": {
      "command": "npx",
      "args": ["@ticktockbent/charlotte"]
    }
  }
}

Amp

~/.amp/settings.json に追加:

{
  "mcpServers": {
    "charlotte": {
      "command": "npx",
      "args": ["@ticktockbent/charlotte"]
    }
  }
}

完全なセットアップガイド(開発モード、汎用 MCP クライアント、検証手順、トラブルシューティングを含む)は docs-internal/mcp-setup.md を参照してください。

設定

Charlotte は 4 つのソースから設定を解決します。優先度が高い順に、CLI 引数 → 環境変数 → 設定ファイル → 組み込みデフォルト です。完全なリファレンスは docs/configuration.md を参照してください。

設定ファイル

--config で JSON 設定ファイルを渡すか、作業ディレクトリに charlotte.config.json を置くと、Charlotte が自動的にロードします:

charlotte --config charlotte.config.json
{
  "browser": { "headless": true, "noSandbox": false },
  "tools": { "profile": "browse" },
  "rendering": { "includeIframes": false, "iframeDepth": 3 },
  "output": { "dir": "./charlotte-output" },
  "limits": {
    "maxInteractiveElements": 2000,
    "maxFullContentChars": 200000,
    "maxResponseBytes": 1000000,
    "maxEvaluateBytes": 256000
  }
}

すべてのセクションはオプションです。空の {} も有効です。ファイルは zod で検証されます。不明なキー、間違った型、または無効な enum 値があると、stderr に明確な起動エラーが出力され、Charlotte は非ゼロで終了します。4 つの設定には環境変数もあります: CHARLOTTE_NO_SANDBOX、CHARLOTTE_OUTPUT_DIR、CHARLOTTE_CDP_ENDPOINT、CHARLOTTE_INIT_SCRIPT。ページの JS の前にすべての新しいドキュメントで実行する必要があるスクリプトは、browser.initScripts または --init-script <path>(繰り返し可能)に配置します。初期化スクリプト を参照してください。

Chromium サンドボックスはデフォルトでオン

v0.7.0 の動作変更: 以前のリリースでは、すべての Chromium 起動に --no-sandbox を組み込んでいました。v0.7.0 以降、Chromium サンドボックスはデフォルトで有効です。これは、信頼できないページと Charlotte が実行されるアカウントとの間の主要な防御です。カーネルサンドボックスが利用できない環境では、明示的にオプトアウトする必要があります。

charlotte --no-sandbox                  # CLI flag
CHARLOTTE_NO_SANDBOX=1 charlotte        # environment variable
# or "browser": { "noSandbox": true }   in the config file

移行に関する注意(Docker / ベアメタル): コンテナは通常カーネルサンドボックスをセットアップできないため、提供されている Dockerfile は CHARLOTTE_NO_SANDBOX=1 を設定します。また、docker-compose.yml は Docker のデフォルトの seccomp フィルターを維持します(seccomp=unconfined では実行されなくなりました)。Charlotte を root としてベアメタルで実行する場合、Chromium はサンドボックスを有効にしたまま起動を拒否します。非 root ユーザーとして実行するか(推奨)、--no-sandbox を渡してください。以前は暗黙の --no-sandbox に依存していて、サンドボックスを初期化できない環境で実行している既存のセットアップは、引き続き動作させるために CHARLOTTE_NO_SANDBOX=1(またはフラグ/設定の同等物)を設定する必要があります。

Charlotte Remote(HTTP モード)をネットワーク経由で実行すると、サンドボックス以外にも追加の信頼境界とネットワークガードの問題が発生します。セキュリティ を参照してください。

出力サイズ制限

limits.* キーは、単一のツール応答が返すことができる量を制限し、病的なページ(10 万個のリンク、無限スクロールフィード、巨大なドキュメント本文)がエージェントのコンテキストウィンドウをオーバーフローさせないようにします。ページ応答が maxResponseBytes を超えると、コンパクトな要約に縮退し、output_file を使用して完全な結果をディスクに書き込むことを提案します。charlotte_evaluate の結果は maxEvaluateBytes によって独立して制限されます。切り詰められた応答には truncation マーカーが付きます。キーとデフォルトについては docs/configuration.md を参照してください。

クラッシュリカバリ

Chromium のクラッシュでサーバーが動かなくなることはなくなりました。次のツール呼び出しでブラウザが自動的に再起動され、死んだタブと CDP セッションキャッシュがクリアされ、新しい空白のタブが開きます。これにより、エージェントは MCP サーバーを再起動せずにレンダラークラッシュ後も作業を続けることができます。

使用例

接続すると、エージェントはCharlotteのツールを使用できます:

ウェブサイトを閲覧する

navigate({ url: "https://example.com" })
// → 612 chars: landmarks, headings, interactive element counts

find({ type: "link", text: "More information" })
// → just the matching element with its ID

click({ element_id: "lnk-a3f1c2" })

フォームに入力する

navigate({ url: "https://httpbin.org/forms/post" })
find({ type: "text_input" })
type({ element_id: "inp-c7e29b", text: "hello@example.com" })
select({ element_id: "sel-e8a3f5", value: "option-2" })
submit({ form_id: "frm-b1d4e7" })

ローカル開発のフィードバックループ

dev_serve({ path: "./my-site", watch: true })
observe({ detail: "full" })
dev_audit({ checks: ["a11y", "contrast"] })
dev_inject({ css: "body { font-size: 18px; }" })

ページ表現

Charlotteは、エージェントが消費するコンテキスト量を制御できる3つの詳細レベルを持つ構造化表現を返します:

Minimal(navigateのデフォルト)

ランドマーク、見出し、ページ領域ごとにグループ化されたインタラクティブ要素の数を返します。すべての要素を列挙せずに「このページには何があるか?」という方向確認のために設計されています。

{
  "url": "https://news.ycombinator.com",
  "title": "Hacker News",
  "viewport": { "width": 1280, "height": 720 },
  "structure": {
    "headings": [{ "level": 1, "text": "Hacker News", "id": "hdg-a1b2c3" }]
  },
  "interactive_summary": {
    "total": 93,
    "by_landmark": {
      "(page root)": { "link": 91, "text_input": 1, "button": 1 }
    }
  }
}

Summary(observeのデフォルト)

型付きメタデータ、フォーム構造、コンテンツ概要を含む完全なインタラクティブ要素リスト。

{
  "url": "https://example.com/dashboard",
  "title": "Dashboard",
  "viewport": { "width": 1280, "height": 720 },
  "structure": {
    "landmarks": [
      { "id": "rgn-b2c1d0", "role": "banner", "label": "Site header", "bounds": { "x": 0, "y": 0, "w": 1280, "h": 64 } },
      { "id": "rgn-d4e5f6", "role": "main", "label": "Content", "bounds": { "x": 240, "y": 64, "w": 1040, "h": 656 } }
    ],
    "headings": [{ "level": 1, "text": "Dashboard", "id": "hdg-1a2b3c" }],
    "content_summary": "main: 2 headings, 5 links, 1 form"
  },
  "interactive": [
    {
      "id": "btn-a3f1c2",
      "type": "button",
      "label": "Create Project",
      "bounds": { "x": 960, "y": 80, "w": 160, "h": 40 },
      "state": {}
    }
  ],
  "forms": []
}

Full

summaryのすべてに加え、ページ上のすべての表示テキストコンテンツ。

詳細レベル

レベル

トークン

ユースケース

minimal

~50-200

ナビゲーション後の方向確認。どの領域が存在するか?インタラクティブ要素はいくつあるか?

summary

~500-5000

ページでの作業。完全な要素リスト、フォーム構造、コンテンツ概要。

full

可変

ページコンテンツの読み取り。すべての表示テキストを含む。

ナビゲーションツールはデフォルトでminimalです。observeツールはデフォルトでsummaryです。どちらもオプションのdetailパラメータで上書きできます。

要素ID

要素IDは軽微なDOM変更に対して安定しています。要素タイプ、ARIAロール、アクセシブル名、DOMパスシグネチャの複合キーをハッシュ化して生成されます:

btn-a3f1c2  (button)    inp-c7e29b  (text input)
lnk-d4b910  (link)      sel-e8a3f5  (select)
chk-f1a204  (checkbox)  frm-b1d4e7  (form)
rgn-e0d2a8  (landmark)  hdg-0f4063  (heading)
dom-b2c3d9  (DOM element, from CSS selector queries)

v0.7.0 ID形式の変更: 要素IDハッシュは以前のリリースの4文字から、現在は6桁の16進文字(例:btn-a3f1c2)になりました。これにより、大規模ページでの要素間ハッシュ衝突が大幅に減少します。4文字のIDをハードコードまたはパターンマッチしていたエージェントは、アップグレード後はキャッシュされたIDを再利用せず、要素を再findする必要があります。

IDは無関係なDOM変更や同じコンテナ内の要素の並べ替えでも維持されます。エージェントがminimal詳細度でナビゲートする場合(個別の要素IDなし)、findを使用してテキスト、タイプ、または空間的近接性で要素を特定します。返された要素には操作可能なIDが含まれています。

開発

# Run in watch mode
npm run dev

# Run all tests
npm test

# Run only unit tests
npm run test:unit

# Run only integration tests
npm run test:integration

# Type check
npx tsc --noEmit

プロジェクト構造

src/
  browser/          # Puppeteer lifecycle, tab management, CDP sessions
  renderer/         # Accessibility tree extraction, layout, content, element IDs
  state/            # Snapshot store, structural differ
  tools/            # MCP tool definitions (navigation, observation, interaction, session, dev-mode)
  dev/              # Static server, file watcher, auditor
  types/            # TypeScript interfaces
  utils/            # Logger, hash, wait utilities
tests/
  unit/             # Fast tests with mocks
  integration/      # Full Puppeteer tests against fixture HTML
  fixtures/pages/   # Test HTML files

アーキテクチャ

Renderer Pipelineが中核です。抽出器を順番に呼び出してPageRepresentationを組み立てます:

  1. アクセシビリティツリー抽出(CDP Accessibility.getFullAXTree)

  2. レイアウト抽出(CDP DOM.getBoxModel)

  3. ランドマーク、見出し、インタラクティブ要素、コンテンツの抽出

  4. 要素ID生成(ハッシュベース、再レンダリング間で安定)

すべてのツールはrenderActivePage()を経由します。これはスナップショット、リロードイベント、ダイアログ検出、レスポンスフォーマットを処理します。

サンドボックス

Charlotteにはtests/sandbox/にテスト用ウェブサイトが含まれており、パブリックインターネットに接続せずにすべてのツールを試すことができます。ローカルで次のように起動します:

dev_serve({ path: "tests/sandbox" })

5つのページがナビゲーション、フォーム、インタラクティブ要素、ポップアップ、遅延コンテンツ、スクロールコンテナなどをカバーしています。完全なページリファレンスとツール別の演習チェックリストについては、docs-internal/sandbox.mdを参照してください。

既知の問題

Shadow DOM — オープンShadow DOMは透過的に動作します。Chromiumのアクセシビリティツリーはオープンシャドウ境界を貫通するため、Webコンポーネント(例:GitHubの<relative-time>、<tool-tip>)は特別な処理なしでそのコンテンツがCharlotteの表現にレンダリングされます。クローズドシャドウルートはアクセシビリティツリーに対して不透明であり、キャプチャされません。

ロードマップ

セッションと設定

機能ロードマップ

ビデオ録画 — インタラクションをビデオとして記録し、エージェント主導のナビゲーションと操作の全シーケンスをキャプチャして、デバッグ、ドキュメント作成、レビューに使用します。

Playwright MCPに対する完全なギャップ分析(優先度の低い項目(ビジョンツール、テスト/検証、トレーシング、トランスポート、セキュリティ)とCharlotteが優位性を持つ領域を含む)については、docs-internal/playwright-mcp-gap-analysis.mdを参照してください。

完全な仕様

すべてのツールパラメータ、ページ表現形式、要素識別戦略、アーキテクチャの詳細を含む完全な仕様については、docs-internal/CHARLOTTE_SPEC.mdを参照してください。

ライセンス

MIT

コミュニティ

  • 再現可能な欠陥、リグレッション、またはMCPクライアント固有の問題については、バグレポートを開いてください。

  • ワークフローの改善や新機能については、機能リクエストを開いてください。

  • 新しいツール、パラメータサーフェス、プロファイル配置を提案したい場合は、ツールリクエストを開いてください。

  • 現在の作業と議論を見つけるには、オープンイシューを閲覧してください。

  • メンテナーが初心者向けタスクにタグを付けているため、予定されているgood first issueフィルタを確認してください。

コントリビューション

ガイドラインについてはCONTRIBUTING.mdを参照してください。


文学的な名前を持つMCPサーバーの成長するスイートの一部です。詳細はgithub.com/TickTockBentをご覧ください。

Available Tools

23 tools
charlotte_backA

Navigate back in browser history. Returns page representation after navigation.

Inputs: detail.

charlotte_clickA

Click an interactive element on the page. Returns full page representation after the click.

Inputs: element_id (required), modifiers, click_type.

charlotte_click_atA

Click at specific page coordinates. Use when target elements are not in the accessibility tree (custom widgets, canvas, non-semantic interactive divs). Dispatches real CDP-level mouse events. Returns full page representation after the click.

Inputs: x (required), y (required), modifiers, click_type.

charlotte_diffA

Compare current page state to a previous snapshot. Returns structural diff showing added, removed, moved, and changed elements.

Inputs: scope, snapshot_id.

charlotte_findA

Search for elements matching criteria. Filters interactive elements by text, role, type, or spatial proximity. Use the selector parameter to find DOM elements by CSS selector — this reaches elements not in the accessibility tree (custom widgets, non-semantic divs). Selector results return Charlotte element IDs usable with click, hover, drag, etc.

Inputs: near, role, text, type, +3 more.

charlotte_forwardA

Navigate forward in browser history. Returns page representation after navigation.

Inputs: detail.

charlotte_navigateA

Load a URL in the active page. Returns page representation after navigation. Default minimal detail includes landmarks, headings, and interactive element counts — use charlotte_find to locate specific elements, or pass detail: 'summary' to get the full element list.

Inputs: url (required), detail, timeout, wait_for.

charlotte_observeA

Get current page state without performing any action. Use detail levels to control verbosity: "minimal" for landmarks, headings, and interactive element counts by landmark (use charlotte_find to get specific elements with actionable IDs, or observe({ detail: "summary" }) to see all elements), "summary" (default) for content summaries and full element list, "full" for all text content. Use view: "tree" for a compact structural outline (cheapest orientation tool), or view: "tree-labeled" to include labels on interactive elements (still much cheaper than minimal JSON, and shows which button/link/input is which).

Inputs: view, detail, selector, output_file, +1 more.

charlotte_reloadA

Reload the current page. Returns page representation after reload.

Inputs: hard, detail.

charlotte_screenshotA

Capture a visual screenshot. Fallback for when structured representation isn't sufficient (complex visualizations, canvas elements, images). Use save: true to persist as a file artifact that can be referenced later.

Inputs: save, format, quality, selector, +2 more.

charlotte_screenshot_deleteA

Delete a saved screenshot artifact by its ID. Removes the file from disk.

Inputs: id (required).

charlotte_screenshot_getA

Retrieve a previously saved screenshot artifact by its ID. Returns the image data and metadata.

Inputs: id (required).

charlotte_screenshotsA

List all saved screenshot artifacts. Returns metadata for each saved screenshot including ID, filename, page URL, and timestamp.

Inputs: no named parameters.

charlotte_scrollA

Scroll the page or a specific container. Returns full page representation after scrolling.

Inputs: direction (required), amount, element_id.

charlotte_selectA

Select an option in a select/dropdown element. Returns full page representation after selection.

Inputs: value (required), element_id (required).

charlotte_submitB

Submit a form. Can submit by form ID or by clicking its submit button. Returns full page representation after submission.

Inputs: form_id (required).

charlotte_tab_closeA

Close a browser tab by its ID. If the closed tab was active, switches to the first remaining tab.

Inputs: tab_id (required).

charlotte_tab_openA

Open a new browser tab. Optionally navigate to a URL. The new tab becomes the active tab.

Inputs: url.

charlotte_tabsA

List all open browser tabs with their URLs, titles, and active status.

Inputs: no named parameters.

charlotte_tab_switchA

Switch to a different browser tab by its tab ID. Returns the page representation of the activated tab.

Inputs: tab_id (required).

charlotte_toggleA

Toggle a checkbox or switch element. Returns full page representation after toggle.

Inputs: element_id (required).

charlotte_toolsA

Manage Charlotte tool visibility. Lists available tool groups and their status. Use 'enable' or 'disable' to control which tools are loaded. Disabled tools don't appear in the tool list — enable a group to access its tools. Groups: 'interaction' for form filling, clicking, and drag-and-drop. 'session' for cookie/auth management, tab switching, viewport, and network. 'dev_mode' for local development serving and audits. 'evaluate' for JavaScript execution. 'monitoring' for console and network request logs. 'dialog' for JavaScript dialog handling.

Inputs: group, action.

charlotte_typeA

Type text into an input element. Returns full page representation after typing.

Inputs: text (required), element_id (required), slowly, clear_first, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 23 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: navigation, tab management, interaction, observation, and screenshot management are all separated. Even similar tools like charlotte_click and charlotte_click_at are explicitly differentiated by target type (element vs coordinates).

    Naming Consistency4/5

    All tools share the 'charlotte_' prefix and use snake_case, but there is a mix of simple verbs (navigate, click, type) and compound verb_noun forms (tab_open, screenshot_get). This is mostly consistent but not perfectly uniform.

    Tool Count3/5

    With 23 tools, the server is on the heavier side but still within a manageable range for a comprehensive browser automation tool. The count is justified by the breadth of features, though it approaches the threshold where it might feel overwhelming.

    Completeness4/5

    Core browser automation workflows are well covered: navigation, tab management, element interaction, observation, and screenshot handling. However, the description of charlotte_tools mentions groups for dialogs, drag-and-drop, and session management, but these tools are not present in the exposed set, leaving minor gaps.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for web scraping and browser automation, enabling AI agents to extract clean, token-efficient content from web pages.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server providing AI agents with a stealth Chromium browser that uses hybrid accessibility-object-model and set-of-mark vision for token-lean snapshots and reliable action via ref ids.
      13
      73 npm
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that gives AI agents controlled access to the web, offering unified tools for fetching pages as Markdown, searching across multiple providers, and extracting structured data via CSS selectors.
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Gives AI agents token-efficient browser access by returning compact, structured page summaries, targeted element queries, and on-demand detail instead of full accessibility-tree dumps. Supports navigation, interaction, monitoring, and session management through MCP tool profiles.
      4 npm
      MIT