Add screenshot capture, AI vision, OCR, recording, voice dictation, and the full GUI automation suite — 72 MCP tools — to any AI-powered editor or CLI.
npm install -g superbased (or download the desktop app)superbased mcp starts the server automaticallyPlugin available — install via the marketplace for 22 slash commands, 7 skills, and 2 agents:
/plugin marketplace add marmutapp/superbased-claude-code-plugin /plugin install superbased@superbased-tools
Or add MCP server manually to ~/.claude/settings.json (global) or .mcp.json (per-project):
{ "mcpServers": { "superbased": { "command": "superbased", "args": ["mcp"] } } }
Plugin available — includes 22 slash commands, 7 skills, 2 agents, and 3 Cursor rules. Submit pending at Cursor Marketplace. Plugin repo: marmutapp/superbased-cursor-plugin
Add MCP server to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):
{ "mcpServers": { "superbased": { "command": "superbased", "args": ["mcp"] } } }
Add to ~/.codeium/windsurf/mcp_config.json to make it available in all Windsurf projects.
{ "mcpServers": { "superbased": { "command": "superbased", "args": ["mcp"] } } }
Submitted to Cline MCP Marketplace — once approved, install directly from the Cline MCP Marketplace panel in VS Code. Submission #1330
Or add manually to ~/Documents/Cline/cline_mcp_settings.json (or use the Cline MCP settings UI in VS Code):
{ "mcpServers": { "superbased": { "command": "superbased", "args": ["mcp"] } } }
Add to opencode.json in your project root. The SUPERBASED_MCP_TEXT_ONLY env var is required while OpenCode's MCP client rejects spec-compliant type:"image" blocks — SuperBased v2.0.5+ honors it by stripping image content.
{ "mcpServers": { "superbased": { "command": "superbased", "args": ["mcp"], "env": { "SUPERBASED_MCP_TEXT_ONLY": "1" } } } }
Add to ~/.config/zed/settings.json under the context_servers key. Zed uses a different schema.
{ "context_servers": { "superbased": { "command": { "path": "superbased", "args": ["mcp"] } } } }
Plugin available — includes 22 slash commands, 7 skills, and 2 agents. Plugin repo: marmutapp/superbased-codex-plugin
Add to ~/.codex/config.toml. Codex uses URL-based MCP (HTTP transport).
[mcp_servers.superbased] enabled = true url = "http://127.0.0.1:47592/mcp"
The URL must end with /mcp — that's the MCP Streamable HTTP endpoint. The root URL is the REST API.
Plugin available — includes 22 slash commands, 7 skills, and 2 agents:
copilot plugin install marmutapp/superbased-copilot-plugin
Or via marketplace: copilot plugin marketplace add marmutapp/superbased-copilot-plugin
Plugin repo: marmutapp/superbased-copilot-plugin
Every tool is available once the MCP server is connected.
Make sure the desktop app is running, or start the headless server with superbased serve. The API listens on http://127.0.0.1:47592 by default.
Double-check the config file path for your tool. Restart your editor after saving the config. Run npx superbased-mcp-server manually to verify it starts without errors.
No AI API key is configured. Open SuperBased Settings and add an API key for your preferred provider (OpenAI, Anthropic, or Google Gemini).
Add an API key in the SuperBased desktop app under Settings. The MCP server proxies AI requests through the desktop app.
Enable recording in the desktop app under Settings > Recording tab before using recording-related MCP tools.
If SuperBased runs on a non-default port, pass it via args: "args": ["-y", "superbased-mcp-server", "--port", "12345"]