Steel MCP Server

A Model Context Protocol (MCP) server that exposes Steel Browser automation over HTTP. It runs a Puppeteer-backed browser session and gives MCP clients standardized tools for browser control. Use it when you want Codex, Claude Code/Desktop, OpenCode, or Antigravity to drive Steel Browser. It exists so MCP clients can control Steel Browser through one standardized HTTP endpoint.

Core capabilities:

• HTTP MCP endpoint for browser automation

• Local Steel Browser via Docker Compose or Steel Cloud via API key

• Page interaction, extraction, tabs, and session controls

• Screenshots, PDFs, and quick scrape actions

• Cookie/localStorage management and file uploads

Getting Started

Quick Install Links

Related MCP server: Playwright MCP Server

Install (Docker)

Requires Docker + Compose. No repo clone needed.

Start the bundled Steel Browser stack and MCP server:

docker compose up -d

The compose stack exposes:

• Steel Browser API: http://localhost:3000

• Steel Browser UI: http://localhost:5171

• MCP server: http://localhost:8787/mcp

If you want Docker-only usage without cloning the repo:

curl -O https://raw.githubusercontent.com/rickicode/steel-browser-mcp/main/compose.yml
MCP_IMAGE=ghcr.io/rickicode/steel-browser-mcp:latest docker compose up -d

Add MCP

MCP HTTP endpoint:

http://localhost:8787/mcp

Standard config:

Add it to your client config:

{
  "mcpServers": {
    "steel-browser": {
      "type": "http",
      "url": "http://localhost:8787/mcp"
    }
  }
}

Make sure the Steel Browser stack is running before connecting.

Client Setup

Use ~/.codex/config.toml:

[mcp_servers.steel-browser]
url = "http://localhost:8787/mcp"
enabled = true

Or add it from the CLI:

codex mcp add steel-browser http://localhost:8787/mcp

Use .mcp.json:

{
  "mcpServers": {
    "steel-browser": {
      "type": "http",
      "url": "http://localhost:8787/mcp"
    }
  }
}

Or add it from the CLI:

claude mcp add steel-browser http://localhost:8787/mcp --type http

Add the standard config above in a connector that supports HTTP MCP. If the server is localhost-only, expose it through a tunnel first.

Use ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "steel-browser": {
      "type": "remote",
      "url": "http://localhost:8787/mcp",
      "enabled": true
    }
  }
}

Use the CLI:

antigravity --add-mcp '{"name":"steel-browser","url":"http://localhost:8787/mcp","type":"http"}'

Antigravity also supports file-based configuration under <repo_root>/.vscode/mcp.json.

For technical details, see docs.md.