Scrapybara MCP
The Scrapybara MCP server allows clients to interact with virtual Ubuntu desktops for web browsing, code execution, and more.
Start an instance: Launch a Scrapybara Ubuntu desktop sandbox and get a stream URL for real-time viewing.
Get instances: Retrieve all running Scrapybara instances.
Stop an instance: Terminate a specific instance using its ID.
Run bash commands: Execute shell commands in a specified instance.
Act on instances: Control an instance through an agent that can perform mouse/keyboard actions and execute commands based on prompts, with optional structured output.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Scrapybara MCP start a new Ubuntu instance and open the browser to github.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol server for Scrapybara. This server enables MCP clients such as Claude Desktop, Cursor, and Windsurf to interact with virtual Ubuntu desktops and take actions such as browsing the web, running code, and more.
Prerequisites
Node.js 18+
pnpm
Scrapybara API key (get one at scrapybara.com)
Related MCP server: taw-computer
Installation
Clone the repository:
git clone https://github.com/scrapybara/scrapybara-mcp.git
cd scrapybara-mcpInstall dependencies:
pnpm installBuild the project:
pnpm buildAdd the following to your MCP client config:
{
"mcpServers": {
"scrapybara-mcp": {
"command": "node",
"args": ["path/to/scrapybara-mcp/dist/index.js"],
"env": {
"SCRAPYBARA_API_KEY": "<YOUR_SCRAPYBARA_API_KEY>",
"ACT_MODEL": "<YOUR_ACT_MODEL>", // "anthropic" or "openai"
"AUTH_STATE_ID": "<YOUR_AUTH_STATE_ID>" // Optional, for authenticating the browser
}
}
}
}Restart your MCP client and you're good to go!
Tools
start_instance - Start a Scrapybara Ubuntu instance. Use it as a desktop sandbox to access the web or run code. Always present the stream URL to the user afterwards so they can watch the instance in real time.
get_instances - Get all running Scrapybara instances.
stop_instance - Stop a running Scrapybara instance.
bash - Run a bash command in a Scrapybara instance.
act - Take action on a Scrapybara instance through an agent. The agent can control the instance with mouse/keyboard and bash commands.
Contributing
Scrapybara MCP is a community-driven project. Whether you're submitting an idea, fixing a typo, adding a new tool, or improving an existing one, your contributions are greatly appreciated!
Before contributing, read through the existing issues and pull requests to see if someone else is already working on something similar. That way you can avoid duplicating efforts.
If there are more tools or features you'd like to see, feel free to suggest them on the issues page.
Available Tools
5 toolsactB
Take action on a Scrapybara instance through an agent. The agent can control the instance with mouse/keyboard and bash commands.
Inputs: instance_id (required), prompt (required), schema.
bashC
Run a bash command in a Scrapybara instance.
Inputs: instance_id (required), command (required).
get_instancesB
Get all running Scrapybara instances.
Inputs: no named parameters.
start_instanceA
Start a Scrapybara Ubuntu instance. Use it as a desktop sandbox to access the web or run code. Always present the stream URL to the user afterwards so they can watch the instance in real time.
Inputs: no named parameters.
stop_instanceC
Stop a running Scrapybara instance.
Inputs: instance_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: act controls the instance via agent, bash runs commands, get_instances lists instances, start_instance creates one, and stop_instance terminates one. There is no overlap or ambiguity between these functions.
Four tools follow a consistent verb_noun pattern (get_instances, start_instance, stop_instance, run_command would fit but bash is used instead). The tool 'act' deviates as a single verb, and 'bash' is a noun, but overall the naming is mostly consistent and readable.
With 5 tools, this is well-scoped for managing Scrapybara instances. It covers core lifecycle operations (start, stop, list) and usage actions (act, bash), with each tool earning its place without bloat or thinness.
The toolset provides good coverage for instance management and interaction, including lifecycle (start, stop, list) and control (act, bash). A minor gap is the lack of a tool for configuring or modifying instances, but agents can work around this using bash or act.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
A Model Context Protocol server for Wix AI tools
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA desktop automation MCP server that enables AI agents to interact with Linux environments through screenshots, window inspection, and input simulation. It provides tools for mouse control, keyboard input, and screen capture using xdotool and XDG Desktop Portals.MIT
- AlicenseBqualityDmaintenanceAn MCP server that provides AI agents with a full Ubuntu desktop environment inside Docker, enabling them to perform complex computer tasks like browsing, coding, testing, and GUI automation.3613MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants to create, control, and interact with virtual desktop environments through E2B's secure cloud sandboxes.64-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that gives any AI full control over a Windows PC, enabling application control, mouse/keyboard automation, screen capture, browser automation, and more.67 PyPI6MIT