substrate-browser MCP
An open-source MCP server that acts as a headless browser for AI agents. It extracts a tiny semantic graph from web pages, reducing HTML token bloat by 95% to help local LLMs avoid hallucinating during web tasks. It provides tools for navigation, clicking, typing, and screenshotting via a compressed graph interface.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Load a URL and get back a compressed page graph
- Click elements by numeric ID
- Type text into input fields
- Take a visual snapshot with graph data
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
substrate-browser 2.0.2
{
"version": "2.0.2",
"transport": "stdio",
"identifier": "substrate-browser",
"registryType": "npm",
"environmentVariables": [
{
"name": "SUBSTRATE_PROXY",
"format": "string",
"description": "Optional egress proxy URL (http/socks) to route all Chromium traffic through, mitigating SSRF and DNS rebinding risks."
},
{
"name": "SUBSTRATE_VIEWPORT_WIDTH",
"format": "string",
"description": "Browser viewport width in pixels (Default: 1280)"
},
{
"name": "SUBSTRATE_VIEWPORT_HEIGHT",
"format": "string",
"description": "Browser viewport height in pixels (Default: 800)"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"substrate-browser-mcp": {
"command": "npx",
"args": [
"-y",
"substrate-browser@2.0.2"
],
"env": {
"SUBSTRATE_PROXY": "<YOUR_SUBSTRATE_PROXY>",
"SUBSTRATE_VIEWPORT_WIDTH": "<YOUR_SUBSTRATE_VIEWPORT_WIDTH>",
"SUBSTRATE_VIEWPORT_HEIGHT": "<YOUR_SUBSTRATE_VIEWPORT_HEIGHT>"
}
}
}
}Cline
{
"mcpServers": {
"substrate-browser-mcp": {
"command": "npx",
"args": [
"-y",
"substrate-browser@2.0.2"
],
"env": {
"SUBSTRATE_PROXY": "<YOUR_SUBSTRATE_PROXY>",
"SUBSTRATE_VIEWPORT_WIDTH": "<YOUR_SUBSTRATE_VIEWPORT_WIDTH>",
"SUBSTRATE_VIEWPORT_HEIGHT": "<YOUR_SUBSTRATE_VIEWPORT_HEIGHT>"
}
}
}
}VS Code
{
"servers": {
"substrate-browser-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"substrate-browser@2.0.2"
],
"env": {
"SUBSTRATE_PROXY": "<YOUR_SUBSTRATE_PROXY>",
"SUBSTRATE_VIEWPORT_WIDTH": "<YOUR_SUBSTRATE_VIEWPORT_WIDTH>",
"SUBSTRATE_VIEWPORT_HEIGHT": "<YOUR_SUBSTRATE_VIEWPORT_HEIGHT>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"substrate-browser-mcp": {
"command": "npx",
"args": [
"-y",
"substrate-browser@2.0.2"
],
"env": {
"SUBSTRATE_PROXY": "<YOUR_SUBSTRATE_PROXY>",
"SUBSTRATE_VIEWPORT_WIDTH": "<YOUR_SUBSTRATE_VIEWPORT_WIDTH>",
"SUBSTRATE_VIEWPORT_HEIGHT": "<YOUR_SUBSTRATE_VIEWPORT_HEIGHT>"
}
}
}
}Let your agent find its tools
Find servers like substrate-browser MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.