Features Agents Observer Pricing Changelog

Connect SuperBased to your AI coding tool

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 superbased npm @superbased/observer View on Product Hunt

Prerequisites

  1. Install SuperBased — run npm install -g superbased (or download the desktop app)
  2. Add the MCP config below to your AI editor — superbased mcp starts the server automatically

Claude Code

Plugin available — install via the marketplace for 22 slash commands, 7 skills, and 2 agents:

plugin
/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):

json
{
  "mcpServers": {
    "superbased": {
      "command": "superbased",
      "args": ["mcp"]
    }
  }
}

Cursor

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):

json
{
  "mcpServers": {
    "superbased": {
      "command": "superbased",
      "args": ["mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json to make it available in all Windsurf projects.

json
{
  "mcpServers": {
    "superbased": {
      "command": "superbased",
      "args": ["mcp"]
    }
  }
}

Cline

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):

json
{
  "mcpServers": {
    "superbased": {
      "command": "superbased",
      "args": ["mcp"]
    }
  }
}

OpenCode

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.

json
{
  "mcpServers": {
    "superbased": {
      "command": "superbased",
      "args": ["mcp"],
      "env": {
        "SUPERBASED_MCP_TEXT_ONLY": "1"
      }
    }
  }
}

Zed

Add to ~/.config/zed/settings.json under the context_servers key. Zed uses a different schema.

json
{
  "context_servers": {
    "superbased": {
      "command": {
        "path": "superbased",
        "args": ["mcp"]
      }
    }
  }
}

OpenAI Codex

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).

toml
[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.

GitHub Copilot CLI

Plugin available — includes 22 slash commands, 7 skills, and 2 agents:

cli
copilot plugin install marmutapp/superbased-copilot-plugin

Or via marketplace: copilot plugin marketplace add marmutapp/superbased-copilot-plugin

Plugin repo: marmutapp/superbased-copilot-plugin

72 MCP Tools Available

Every tool is available once the MCP server is connected.

superbased_capture
Fullscreen, region, or active window screenshot
superbased_ai
AI vision analysis with slash commands
superbased_ocr
Extract text from screenshots via OCR
superbased_gallery
List, search, and get stats on captures
superbased_gallery_update
Tag and add notes to captures
superbased_settings
Read and update app settings
superbased_presets
Manage AI instruction presets
superbased_recording
Start, pause, resume, and stop recordings
superbased_sessions
List and manage recording sessions
superbased_export
Export sessions as HTML or other formats
superbased_compress_text
Compress text to images for token savings
superbased_capture_image
Get raw capture image data
superbased_gallery_image
Get image data from gallery captures
superbased_diff
Visual diff between two captures
superbased_health
Check app status and feature availability
superbased_redact
Redact sensitive info from screenshots
superbased_auth
Manage authentication state
superbased_license
Check license and subscription status
superbased_transcribe
Transcribe audio via Whisper
superbased_ai_usage
Check daily AI call and token usage
superbased_window_list
List all open windows on screen
superbased_dictation_history
Access voice dictation transcription history
superbased_describe_frames
AI description of recording frames
superbased_narrate
Generate narration for recording sessions
superbased_baseline
Set visual baselines for regression testing
superbased_dictate
Voice dictation control
superbased_annotate
Add annotations to screenshots
superbased_clipboard
Read and write system clipboard

Troubleshooting

"Cannot connect to SuperBased"

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.

MCP tools don't appear in your editor

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.

Health check returns "ai": false

No AI API key is configured. Open SuperBased Settings and add an API key for your preferred provider (OpenAI, Anthropic, or Google Gemini).

"No AI provider configured"

Add an API key in the SuperBased desktop app under Settings. The MCP server proxies AI requests through the desktop app.

Recording tools fail

Enable recording in the desktop app under Settings > Recording tab before using recording-related MCP tools.

Using a custom port

If SuperBased runs on a non-default port, pass it via args: "args": ["-y", "superbased-mcp-server", "--port", "12345"]