Mobbin Agent
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., "@Mobbin Agent Find trending dashboard screens and download top 20"
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.
Mobbin Agent
MCP server that gives AI agents browser-based access to Mobbin for design research, screen discovery, and screenshot collection.
Claude Code (AI reasoning + decisions)
↕ MCP Protocol (stdio)
Mobbin Agent (TypeScript MCP server)
↕ Playwright (browser automation)
Mobbin.com (authenticated session)
↕ Local filesystem
data/downloads/ (saved screenshots)The AI agent decides what to browse, search, and download. The MCP server provides deterministic browser control tools. No extra LLM cost per browser action.
Features
10 MCP tools — lifecycle, navigation, interaction, perception, collection
Session persistence — authenticate once, sessions auto-restore across runs
Structured extraction — page data returned as classified JSON (screens, flows, apps, categories)
Full-resolution downloads — batch download screen images at 1920px PNG quality
Anti-detection — realistic user agent, disabled automation flags, human-like delays
Direct script access — bypass MCP and import modules directly for batch tasks
Related MCP server: @meshbrow/mcp-server
Requirements
Node.js >= 18
A Mobbin account (free or paid)
Setup
git clone git@github.com:ismailsaleekh/mobbin-agent.git
cd mobbin-agent
npm install
npx playwright install chromium
npm run buildFirst-time authentication
Mobbin requires login. On first use, authenticate in a visible browser window — the session is saved automatically for future runs.
node -e "
import('./dist/browser.js').then(async ({ BrowserManager }) => {
const { MobbinNavigator } = await import('./dist/mobbin.js');
const browser = new BrowserManager();
await browser.launch({ headless: false });
const mobbin = new MobbinNavigator(browser);
const result = await mobbin.login();
console.log(result);
await browser.close();
process.exit(0);
});
"A Chromium window opens to mobbin.com/login. Log in manually — the server detects completion and saves cookies to data/session/storage-state.json. Sessions last ~24-48 hours.
Usage with Claude Code
Add to your Claude Code MCP configuration:
{
"mcpServers": {
"mobbin": {
"command": "node",
"args": ["/absolute/path/to/mobbin-agent/dist/index.js"]
}
}
}Then ask Claude to browse Mobbin:
"Find trending dashboard screen patterns on Mobbin and download the top 20 at full resolution"
"Browse onboarding flows on Mobbin and extract the screen URLs for e-commerce apps"
Tools
10 tools across 5 categories:
Category | Tool | Description |
Lifecycle |
| Launch browser and restore saved session |
| Navigate to login page for manual authentication | |
| Save session and close browser | |
Navigation |
| Go to any Mobbin URL, wait for load |
| Scroll page to load more content (infinite scroll) | |
Interaction |
| Click element by text, CSS selector, or coordinates |
| Type text into input field | |
Perception |
| Take viewport screenshot (returns PNG) |
| Extract structured data from current page | |
Collection |
| Download screen images by URL to local filesystem |
See Tool Reference for parameters, return formats, and examples.
Example: Batch collection script
gather.mjs collects screen images by pattern — bypasses MCP and imports modules directly:
# Collect trending dashboard screens
PATTERN=Dashboard node gather.mjs
# Collect most popular checkout screens with more scrolling
PATTERN=Checkout SORT=mostPopular MAX_SCROLLS=12 node gather.mjsImages are saved to data/downloads/{pattern}/ at full 1920px PNG resolution.
Project structure
mobbin-agent/
├── src/
│ ├── index.ts # MCP server entry point (stdio transport)
│ ├── browser.ts # Playwright browser lifecycle and interactions
│ ├── mobbin.ts # Mobbin domain logic (login, extract, classify)
│ └── tools.ts # MCP tool definitions and handlers
├── docs/ # Full documentation
│ ├── INDEX.md # Tool reference (all 10 tools)
│ ├── OPERATIONAL-GUIDE.md # Workflows, rules, recipes
│ ├── connection.md # MCP setup, session, direct usage
│ ├── tools/ # Detailed tool docs (5 files)
│ ├── reference/ # URL patterns, page types
│ └── troubleshooting/ # Known issues and solutions
├── gather.mjs # Batch collection example script
├── data/
│ ├── session/ # Saved browser session (gitignored)
│ └── downloads/ # Downloaded images (gitignored)
├── MOBBIN-INSTRUCTIONS.md # Mandatory reading for AI agents
├── package.json
└── tsconfig.jsonDocumentation
Document | Purpose |
Entry point — key rules for AI agents | |
All 10 tools with links to detailed docs | |
Rules, collection workflows, script templates, timeouts | |
MCP config, browser lifecycle, session persistence, direct script usage | |
Search templates, filter catalogs, CDN URLs | |
Page classification reference | |
Known issues and solutions |
Tech stack
Component | Technology |
MCP server |
|
Browser automation |
|
Language | TypeScript 5.8 (ESM, strict) |
Transport | stdio (JSON-RPC 2.0) |
Session storage | Playwright |
License
MIT
Available Tools
10 toolsmobbin_clickA
Click on an element in the current page. Provide one of: text (click element containing text), selector (CSS selector), or x+y coordinates.
Inputs: x, y, text, selector.
mobbin_connectA
Launch a browser and connect to Mobbin. Restores saved session if available. Use headless=false for first-time login (so you can see the browser window). After connecting, use mobbin_login if not authenticated.
Inputs: headless.
mobbin_disconnectA
Close the browser and save the current session. The session can be restored on the next mobbin_connect call.
Inputs: no named parameters.
mobbin_downloadA
Download one or more images by URL to the local filesystem. Images are saved to the downloads directory: mobbin-agent/data/downloads/ Returns the list of saved file paths.
Inputs: urls (required), prefix.
mobbin_extractA
Extract structured data from the current Mobbin page. Returns: page type, headings, all links (with Mobbin-specific filtering for screens/flows/apps/categories), all images (with design-relevant image filtering), and a text preview. Use this to understand page content without taking a screenshot.
Inputs: no named parameters.
mobbin_loginA
Navigate to Mobbin login page and wait for the user to authenticate manually. The browser must be launched in non-headless mode (mobbin_connect with headless=false). Waits up to 5 minutes for login completion, then saves session cookies.
Inputs: no named parameters.
mobbin_screenshotA
Take a screenshot of the current browser viewport. Returns a PNG image. Use this to see what is currently displayed on the Mobbin page.
Inputs: fullPage.
mobbin_scrollA
Scroll the current page up or down. Useful for loading more content (Mobbin uses infinite scroll). Returns scroll position.
Inputs: amount, direction.
mobbin_typeA
Type text into an input field. Optionally specify a CSS selector for the target input. Can press Enter after typing.
Inputs: text (required), clear, selector, pressEnter.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a distinct responsibility: session lifecycle (connect/login/disconnect), navigation, observation (screenshot/extract), interaction (click/type/scroll), and asset retrieval (download). There is no meaningful overlap between tools, and any apparent boundaries like connect vs navigate are clearly explained.
All tool names follow the same mobbin_<verb> pattern using lowercase snake_case. The verbs are direct and describe exactly what each tool does, making the set predictable and easy for an agent to reason about.
Ten tools is a well-scoped set for a browser automation server focused on Mobbin. Each tool contributes a necessary capability without redundancy, and the count feels appropriate for the workflow of connecting, navigating, extracting, and downloading.
The tool surface covers the full lifecycle needed to work with Mobbin: session management, manual authentication, navigation to known screens/flows, page inspection, interaction, scrolling for infinite content, screenshots, and downloading images. There are no critical missing operations for the apparent domain.
Maintenance
Related MCP Connectors
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Scrape, crawl and search the web for AI agents via MCP.
A paid remote MCP for AI agent browser approval MCP, built to return verdicts, receipts, usage logs,
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents real browser capabilities including screenshotting, action execution, data extraction, and multi-persona auditing for frontend validation.43 npm7MIT

@meshbrow/mcp-serverofficial
AlicenseNot gradedqualityCmaintenanceMCP server for Meshbrow that gives AI agents full browser automation capabilities with stealth anti-detection, enabling natural language control of browser sessions, data extraction, and multi-browser fleets.MIT- FlicenseBqualityDmaintenanceAn MCP server that enables AI coding tools to control a browser for automated actions, UI extraction, network interception, and screenshots.231-
- FlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents to automate browser testing via Chromium, providing tools for navigation, interaction, and inspection.-