io.github.plasmate-labs/plasmate
Browser engine for AI agents. HTML in, Semantic Object Model out. 16x fewer tokens.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
plasmate-mcpclaude mcp add plasmate -- npx -y plasmate-mcp@0.4.1
{
"mcpServers": {
"plasmate": {
"command": "npx",
"args": [
"-y",
"plasmate-mcp@0.4.1"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
plasmate-mcp
MCP server for Plasmate - 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
# 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
claude mcp add plasmate -- npx plasmate-mcp
Or manually add to ~/.claude/settings.json:
{
"mcpServers": {
"plasmate": {
"command": "npx",
"args": ["-y", "plasmate-mcp"]
}
}
}
Use with Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"plasmate": {
"command": "npx",
"args": ["-y", "plasmate-mcp"]
}
}
}
Use with Cursor
Add to Cursor's MCP settings:
{
"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.
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
Part of the Plasmate Ecosystem
| Engine | plasmate - The browser engine for agents |
| MCP | plasmate-mcp - Claude Code, Cursor, Windsurf |
| Extension | plasmate-extension - Chrome cookie export |
| SDKs | Python / Node.js / Go / Rust |
| Frameworks | LangChain / CrewAI / AutoGen / Smolagents |
| Tools | Scrapy / Audit / A11y / GitHub Action |
| Resources | Awesome Plasmate / Notebooks / Benchmarks |
| Docs | docs.plasmate.app |
| W3C | Web Content Browser for AI Agents |
Frequently asked questions
What is io.github.plasmate-labs/plasmate?
Browser engine for AI agents. HTML in, Semantic Object Model out. 16x fewer tokens.
How do I install io.github.plasmate-labs/plasmate?
It runs on your machine. In Claude Code: claude mcp add plasmate -- npx -y plasmate-mcp@0.4.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.plasmate-labs/plasmate need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.plasmate-labs/plasmate open source?
Yes. Its code is on GitHub under the Apache-2.0 license.
Who maintains io.github.plasmate-labs/plasmate?
It is published by plasmate-labs. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.