MCP Server

Expose all of Sentinel's browser automation capabilities directly to your AI assistant — no code required. Works with Cursor, Windsurf, and Claude Desktop.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools. Sentinel implements an MCP server — once configured, your AI assistant can navigate pages, fill forms, extract data, and run autonomous agents, all from a natural language prompt.

💬

No code

Ask your AI to scrape a page or automate a flow — no scripts to write.

🔌

Drop-in

Add 5 lines to your MCP config. The browser session persists across tool calls.

⚡

Full API

All 8 Sentinel tools are exposed — goto, act, extract, observe, run, screenshot, and more.

Cursor

Add the following to your Cursor MCP configuration, then restart Cursor. The Sentinel tools will appear in the tool picker automatically.

.cursor/mcp.json

// .cursor/mcp.json  (or Settings → MCP → Add server)
{
  "mcpServers": {
    "sentinel": {
      "command": "npx",
      "args":    ["@isoldex/sentinel/mcp"],
      "env": {
        "GEMINI_API_KEY":    "your-key-here",
        "SENTINEL_HEADLESS": "true"
      }
    }
  }
}

Alternatively: Settings → Features → MCP Servers → Add server and enter the command and args manually.

Windsurf

Edit the Windsurf MCP config file and restart the app.

mcp_config.json

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "sentinel": {
      "command": "npx",
      "args":    ["@isoldex/sentinel/mcp"],
      "env": {
        "GEMINI_API_KEY":    "your-key-here",
        "SENTINEL_HEADLESS": "true"
      }
    }
  }
}

Claude Desktop

Edit the Claude Desktop config file, then restart the app. Set SENTINEL_HEADLESS to false to watch the browser while Claude controls it.

claude_desktop_config.json

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sentinel": {
      "command": "npx",
      "args":    ["@isoldex/sentinel/mcp"],
      "env": {
        "GEMINI_API_KEY":    "your-key-here",
        "SENTINEL_HEADLESS": "false"
      }
    }
  }
}

macOS

~/Library/Application Support/Claude/

Windows

%APPDATA%\Claude\

Available tools

The browser session persists across tool calls within the same MCP server process. Errors are returned as structured isError: true responses — the server never crashes on a tool failure.

Tool	Parameters	Description
sentinel_goto	url: string	Navigate to a URL and wait for the page to settle.
sentinel_act	instruction: string	Perform a natural language action on the current page (click, fill, scroll, etc.).
sentinel_extract	instruction: string, schema: object	Extract structured data from the current page using a natural language instruction and JSON schema.
sentinel_observe	instruction?: string	List interactive elements on the page, optionally filtered by a natural language hint.
sentinel_run	goal: string, maxSteps?: number	Run the autonomous agent loop to achieve a high-level goal.
sentinel_screenshot	—	Take a screenshot of the current page. Returns a base64-encoded PNG.
sentinel_close	—	Close the browser session and release all resources.
sentinel_token_usage	—	Get accumulated token usage and estimated cost for the current session.

Development tips

Environment variables are passed via the env block in your MCP config file.

.env (MCP server env block)

# Show the browser window while Cursor / Claude controls it
SENTINEL_HEADLESS=false

# Use a different model
GEMINI_VERSION=gemini-3-flash-preview

# Use OpenAI instead of Gemini (set in the env block of your MCP config)
# OPENAI_API_KEY=sk-...
# Then change the provider in the MCP server config — or use the default Gemini.

Pro tip

Set SENTINEL_HEADLESS=false while building prompts so you can watch exactly what the browser is doing. Switch to true for production use.