Surfbird MCP

● Active

io.github.terry2010/surfbird-mcp

Self-hosted Kitesurf headless browser: markdown, screenshots, PDF, evaluate, batch.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "surfbird-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "surfbird-mcp@0.1.2"
      ],
      "env": {
        "SURFBIRD_URL": "http://127.0.0.1:8080",
        "SURFBIRD_TOKEN": "<your SURFBIRD_TOKEN>",
        "SURFBIRD_TIMEOUT_MS": "120000"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env SURFBIRD_URL=http://127.0.0.1:8080 --env SURFBIRD_TOKEN='<your SURFBIRD_TOKEN>' --env SURFBIRD_TIMEOUT_MS=120000 --transport stdio surfbird-mcp -- npx -y surfbird-mcp@0.1.2
OpenAI Codex CLI
codex mcp add surfbird-mcp --env SURFBIRD_URL=http://127.0.0.1:8080 --env SURFBIRD_TOKEN='<your SURFBIRD_TOKEN>' --env SURFBIRD_TIMEOUT_MS=120000 -- npx -y surfbird-mcp@0.1.2
VS Code
code --add-mcp '{"name":"surfbird-mcp","type":"stdio","command":"npx","args":["-y","surfbird-mcp@0.1.2"],"env":{"SURFBIRD_URL":"http://127.0.0.1:8080","SURFBIRD_TOKEN":"<your SURFBIRD_TOKEN>","SURFBIRD_TIMEOUT_MS":"120000"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • SURFBIRD_URLBase URL of the Surfbird auth-image REST proxy
  • SURFBIRD_TOKENsecretBearer token matching SURFBIRD_TOKEN on the container
  • SURFBIRD_TIMEOUT_MSPer-tool timeout in milliseconds

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Search & Web
Version
0.1.2
Registry
active
Published
11/14/2026

On GitHub

read Nov 18, 2026
Stars
2
Forks
1
Last push
Nov 17, 2026
License
Apache-2.0

JavaScriptai-agentsbrowser-automationchrome-devtools-protocolcloudflaredockerdocker-imageheadless-browserkitesurfllmmarkdown-extractormcpmcp-servermodel-context-protocolpuppeteerragscreenshotself-hostedweb-scraping

From the README

Surfbird English | 中文 Kitesurf, self-hosted. An unofficial Docker distribution of Cloudflare Kitesurf — the experimental browser engine built for AI agents. Not affiliated with or endorsed by Cloudflare. Kitesurf is Apache-2.0 licensed. Kitesurf parses HTML, applies CSS, runs page JavaScript and renders screenshots — no Chrome, no browser container — and speaks CDP, so Puppeteer/Playwright connect as usual. Upstream only supports wrangler dev locally or deploying to Cloudflare Workers (paid). Surfbird packages it for any VPS. Images Images auto-build daily when upstream cuts a new tag; per-tag pins like terry2010/surfbird:auth-2026.11.8 are also published. Quick start Usage CDP (Puppeteer / Playwright / chrome-devtools-mcp): REST (auth image only): Endpoints: POST /screenshot | /pdf | /content | /source | /markdown | /evaluate | /batch (one action over up to MAXBATCHURLS urls, per-item results), GET /health, GET /openapi.json. /content returns the post-JS rendered DOM; /source returns the original response body ("view source"). All other paths transparently proxy to the engine (landing page, /json/, /rbi/). JS/TS client: surfbird on npm — new Surfbird(url,{token}).markdown(u) etc., plus sb.batch(action, urls). MCP (Model Context Protocol) Two ways to plug Surfbird into an MCP-capable agent (Claude Code, Cursor, Windsurf, …): A. surfbird-mcp — thin wrapper (recommended).…

Read the full README on GitHub →

Alternatives to Surfbird MCP

Best Search & Web servers →

The most-starred Search & Web servers in the index, with their live-check result.

ServerStarsLast pushLive check
Browser Use120,955Nov 2026Working
Scrapling MCP Server102,926Nov 2026Local / not checked
Chrome DevTools MCP58,028Nov 2026Local / not checked
Chrome DevTools MCP58,014Nov 2026Local / not checked
com.puter MCP Server44,182Nov 2026Needs sign-in

Surfbird MCP: questions people ask

Is Surfbird MCP a remote or a local MCP server?
According to its entry in the official MCP registry, Surfbird MCP ships as a local package (npm) that your client starts on your machine.
Does Surfbird MCP need an API key?
Its registry entry declares one required environment variable: SURFBIRD_TOKEN. The config on this page shows where each goes.
Is Surfbird MCP still maintained?
Active: the repository's last commit 2 days ago. Last push Nov 17, 2026, 2 GitHub stars, Apache-2.0 licence. Read from GitHub on Nov 18, 2026.
How do I add Surfbird MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Search & Web →

Add the badge to your site

Show visitors that Surfbird MCP is listed here — it’s also the link we check for a free listing.

Surfbird MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-terry2010-surfbird-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Surfbird MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Surfbird MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-terry2010-surfbird-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.