
Surfbird Mcp
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 toolsPublic 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:8080Base URL of the Surfbird auth-image REST proxy
SURFBIRD_TOKENsecretBearer token matching SURFBIRD_TOKEN on the container
SURFBIRD_TIMEOUT_MSdefault: 120000Per-tool timeout in milliseconds
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
Details
- Repository
- github.com/terry2010/surfbird
- Categories
- Web & Browser Automation, Documents & Knowledge
- Package
surfbird-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active