io.github.plasmate-labs/plasmate
Browser engine for AI agents. HTML in, Semantic Object Model out. 16x fewer tokens.
Open source Open in the app JSON README (API)
About
Browser engine for AI agents. HTML in, Semantic Object Model out. 16x fewer tokens.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- plasmate-labs
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.4.1
- Forks
- 1
- Last push
- 2026-08-17T03:01:13Z
- Repository state
- ativo
- Language
- JavaScript
- License
- Apache-2.0
- Added
- 2026-08-29 04:01:12
- Updated
- 2026-08-29 04:01:12
- Origin id
io.github.plasmate-labs/plasmate
README
# plasmate-mcp
MCP server for [Plasmate](https://plasmate.app) - the browser engine for AI agents.
Gives Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP client the ability to browse the web through Plasmate instead of Chrome.
## Install
```bash
# Install the MCP wrapper
npm install -g plasmate-mcp
# Install the Plasmate engine (pick one)
pip install plasmate
# or: cargo install plasmate
# or: brew tap plasmate-labs/plasmate && brew install plasmate
```
## Use with Claude Code
```bash
claude mcp add plasmate -- npx plasmate-mcp
```
Or manually add to `~/.claude/settings.json`:
```json
{
"mcpServers": {
"plasmate": {
"command": "npx",
"args": ["-y", "plasmate-mcp"]
}
}
}
```
## Use with Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"plasmate": {
"command": "npx",
"args": ["-y", "plasmate-mcp"]
}
}
}
```
## Use with Cursor
Add to Cursor's MCP settings:
```json
{
"mcpServers": {
"plasmate": {
"command": "npx",
"args": ["-y", "plasmate-mcp"]
}
}
}
```
This repo is also a Cursor plugin (`.cursor-plugin/plugin.json` + `mcp.json`). Test locally by copying it to `~/.cursor/plugins/local/plasmate`. Submit the public repo at [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish).
## Available Tools
Once connected, your AI gets these tools:
| Tool | Description |
|------|-------------|
| `fetch_page` | Fetch a URL and get the Semantic Object Model (SOM) |
| `extract_text` | Get clean readable text from any URL |
| `open_page` | Open a persistent browser session |
| `click` | Click elements by SOM ID |
| `evaluate` | Execute JavaScript in the page |
| `close_page` | Close a browser session |
## Why Plasmate instead of Chrome?
- **16.6x fewer tokens** - SOM is dramatically smaller than DOM dumps
- **50x faster** - No rendering engine overhead
- **30MB memory** - vs Chrome's 300MB+
- **Structured output** - Clean JSON, not raw HTML
## Links
- [Plasmate](https://plasmate.app)
- [Documentation](https://docs.plasmate.app)
- [W3C Community Group](https://www.w3.org/community/web-content-browser-ai/)
- [GitHub](https://github.com/plasmate-labs/plasmate)
---
## Part of the Plasmate Ecosystem
| | |
|---|---|
| **Engine** | [plasmate](https://github.com/plasmate-labs/plasmate) - The browser engine for agents |
| **MCP** | [plasmate-mcp](https://github.com/plasmate-labs/plasmate-mcp) - Claude Code, Cursor, Windsurf |
| **Extension** | [plasmate-extension](https://github.com/plasmate-labs/plasmate-extension) - Chrome cookie export |
| **SDKs** | [Python](https://github.com/plasmate-labs/plasmate-python) / [Node.js](https://github.com/plasmate-labs/quickstart-node) / [Go](https://docs.plasmate.app/sdk-go) / [Rust](https://github.com/plasmate-labs/quickstart-rust) |
| **Frameworks** | [LangChain](https://github.com/langchain-ai/langchain/pull/36208) / [CrewAI](https://github.com/plasmate-labs/crewai-plasmate) / [AutoGen](https://github.com/plasmate-labs/autogen-plasmate) / [Smolagents](https://github.com/plasmate-labs/smolagents-plasmate) |
| **Tools** | [Scrapy](https://github.com/plasmate-labs/scrapy-plasmate) / [Audit](https://github.com/plasmate-labs/plasmate-audit) / [A11y](https://github.com/plasmate-labs/plasmate-a11y) / [GitHub Action](https://github.com/plasmate-labs/som-action) |
| **Resources** | [Awesome Plasmate](https://github.com/plasmate-labs/awesome-plasmate) / [Notebooks](https://github.com/plasmate-labs/notebooks) / [Benchmarks](https://github.com/plasmate-labs/plasmate-benchmarks) |
| **Docs** | [docs.plasmate.app](https://docs.plasmate.app) |
| **W3C** | [Web Content Browser for AI Agents](https://www.w3.org/community/web-content-browser-ai/) |