Steel 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

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

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

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

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

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

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

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

For technical details, see docs.md.