Surfbird MCP
● Activeio.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.
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"
}
}
}
}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.2codex 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.2code --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.
- 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.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Browser Use | 120,955 | Nov 2026 | Working |
| Scrapling MCP Server | 102,926 | Nov 2026 | Local / not checked |
| Chrome DevTools MCP | 58,028 | Nov 2026 | Local / not checked |
| Chrome DevTools MCP | 58,014 | Nov 2026 | Local / not checked |
| com.puter MCP Server | 44,182 | Nov 2026 | Needs 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.
More Search & Web servers
Browse all Search & Web →offweb: gemini, gopher and ipfs fetch for agents
thdelmas
Fetch gemini://, gopher:// and ipfs:// URLs for agents. Hosted, signed receipt, x402 per call.
offweb: gemini, gopher and ipfs fetch for agents
thdelmas
Fetch gemini://, gopher:// and ipfs:// URLs for agents. Hosted, signed receipt, x402 per call.
Colorado SOS Business Entity & Registered Agent Search
TheCompanyAtlas
Colorado Secretary of State business entity search with status and registered agent lookup.
Singapore ACRA Company & UEN Lookup
TheCompanyAtlas
Singapore ACRA (Bizfile) company search by name, UEN, SSIC industry code, entity type and status.
Uganda URSB Company, Director & Shareholder Search
TheCompanyAtlas
Uganda URSB company search by name and BRN, with director, secretary and shareholder lookup.
Arcade.fun
theguysaccount
Discover playable browser experiences and manage creator-owned game uploads on Arcade.fun.
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.
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
[](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.