Plasmate Documentation
Plasmate is an open-source, agent-native headless browser engine written in Rust.
It compiles HTML into a Semantic Object Model (SOM) - a structured, token-efficient representation that AI agents can reason about directly. It replaces CDP with a purpose-built Agent Web Protocol (AWP).
Quick Links
| Document | Description |
|---|---|
| MCP Registry | |
| Listed on the official MCP Registry. Install in Claude or Cursor with one click. |
Quick Start | Install Plasmate and run your first fetch in 60 seconds | | Product Spec | Full architecture, market analysis, and technical vision | | AWP Protocol | Agent Web Protocol draft specification | | AWP MVP v0.1 | The 7-method subset shipped in v0.1 | | SOM Reference | Semantic Object Model structure and element addressing | | Roadmap (v0.2) | V8 integration, CDP compatibility, SOM cache, parallel sessions | | Brand Guide | Colors, typography, voice, and the pixie dust system |
Key Numbers
- 4-5 ms per page throughput (100-page local benchmark, 231KB average)
- 10.4x compression on Wikipedia (HTML to SOM token reduction)
- ~30 MB RSS memory baseline per page
- 43 MB single binary (macOS arm64)
- 184 tests passing
- Apache 2.0 license
Architecture at a Glance
Agent (Python/JS/Rust)
|
|-- AWP (native, 7 methods)
|-- CDP (legacy compatibility)
|
Plasmate Engine
|-- HTML Parser (html5ever)
|-- SOM Compiler (regions, elements, budgets)
|-- V8 JS Runtime (script execution, DOM shim)
|-- Network Layer (reqwest, connection pooling, HTTP/2)
|-- Session Manager (cookie persistence, navigation history)
Source
- GitHub: plasmate-labs/plasmate
- License: Apache 2.0
- Website: plasmate.app