terry2010 avatar

Surfbird Mcp

terry2010/surfbird

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

GitHub stars
2
tools
8
auth
Secret needed
transport
STDIO
env vars
3
last updated
Nov 14, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

surf_markdownConverts a web page to Markdown via the Surfbird REST API.

Converts a web page to Markdown via the Surfbird REST API.

No parameter schema in public metadata yet.

surf_contentReturns the post-JS rendered DOM of a page.

Returns the post-JS rendered DOM of a page.

No parameter schema in public metadata yet.

surf_sourceReturns the original response body of a page (view source).

Returns the original response body of a page (view source).

No parameter schema in public metadata yet.

surf_screenshotTakes a screenshot of a page.

Takes a screenshot of a page.

No parameter schema in public metadata yet.

surf_pdfRenders a page to PDF.

Renders a page to PDF.

No parameter schema in public metadata yet.

surf_evaluateEvaluates JavaScript on a page.

Evaluates JavaScript on a page.

No parameter schema in public metadata yet.

surf_batchRuns one action over up to MAX_BATCH_URLS URLs, returning per-item results.

Runs one action over up to MAX_BATCH_URLS URLs, returning per-item results.

No parameter schema in public metadata yet.

surf_healthChecks whether the Surfbird engine is responding.

Checks whether the Surfbird engine is responding.

No parameter schema in public metadata yet.

Sponsors

Configuration

SURFBIRD_URLdefault: http://127.0.0.1:8080

Base URL of the Surfbird auth-image REST proxy

SURFBIRD_TOKENsecret

Bearer token matching SURFBIRD_TOKEN on the container

SURFBIRD_TIMEOUT_MSdefault: 120000

Per-tool timeout in milliseconds

Readme

Surfbird

License release Docker Hub

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


View the full README on GitHub

Details

Repository
github.com/terry2010/surfbird
Categories
Web & Browser Automation, Documents & Knowledge
Package
surfbird-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Web & Browser Automation MCP servers

View all
1hmakt99 avatarVedhahmakt99/vedhaBrowser testing on Playwright that checks the server, not just the screen, before it reports a pass.1stars
2kultmember6banger avatarKloaktkultmember6banger/kloaktCloaked headless browser for AI agents — stealth TLS, smart extraction, SPA fallback1stars
3metadrama avatarObscura MCPmetadrama/obscura-mcpMCP server adapter for Obscura Rust headless browser — web scraping with anti-detection.1stars
4lesnyak-cyber avatarQiksy Bridgelesnyak-cyber/qiksy-mcpBrowser MCP for the Chrome you already have open, via the free Qiksy Bridge extension.0stars
5insideos-designs avatarCowork Qainsideos-designs/cowork-qa-mcpGoal-driven Playwright browser sessions for LLMs, with full action traces and aria-snapshots.0stars
6quartzunit avatarBrowsegrabquartzunit/browsegrabToken-efficient browser agent for local LLMs. Playwright + accessibility tree + MarkGrab.0stars