BypassAPI MCP Server

Give your AI agent real-world web access. This Model Context Protocol server exposes BypassAPI so any MCP client — Claude Desktop, Cursor, Windsurf, Cline, Zed — can fetch any page (even behind Cloudflare or CAPTCHAs), get clean LLM-ready markdown, extract structured data, crawl sites, and map URLs.

Think Firecrawl, but it gets through the pages that block everyone else.

Tools

Tool	What it does
`scrape`	Fetch one page → clean markdown / text / html. Handles JS, Cloudflare, bot walls.
`extract`	Pull structured data from a page with a prompt (optional JSON schema).
`crawl`	Follow links from a start URL, up to N pages / depth.
`map_site`	List a site's URLs (sitemap-style), no content.
`batch`	Scrape up to 50 URLs in one call.
`account`	Check remaining credits + usage.

Get an API key

Install & configure

The server runs via uvx (no manual install) or pip. Add the block below to your client's MCP config and put your key in BYPASSAPI_KEY.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bypassapi": {
      "command": "uvx",
      "args": ["bypassapi-mcp"],
      "env": { "BYPASSAPI_KEY": "psk_live_your_key_here" }
    }
  }
}

Cursor

~/.cursor/mcp.json (or Settings → MCP):

{
  "mcpServers": {
    "bypassapi": {
      "command": "uvx",
      "args": ["bypassapi-mcp"],
      "env": { "BYPASSAPI_KEY": "psk_live_your_key_here" }
    }
  }
}

Windsurf / Cline / Zed

Same shape — a bypassapi entry with command: uvx, args: ["bypassapi-mcp"], and BYPASSAPI_KEY in env.

pip instead of uvx

pip install bypassapi-mcp

then use "command": "bypassapi-mcp" (or "command": "python", "args": ["-m", "bypassapi_mcp"]) in the config above.

Example prompts

Once connected, just ask your agent:

"Scrape the pricing page at example.com and summarize the tiers."
"This site is behind Cloudflare — extract the product name, price, and stock status." (set solve_cf: true if blocked)
"Crawl docs.example.com, 20 pages, and list every API endpoint you find."
"Map competitor.com and tell me which URLs look like blog posts."

Configuration (env)

Var	Default	Notes
`BYPASSAPI_KEY`	—	Required. Your API key.
`BYPASSAPI_BASE`	`https://bypassapi.com`	Override for self-hosted / staging.
`BYPASSAPI_TIMEOUT`	`120`	Per-request timeout (seconds).

Notes

Each call spends credits from your account (scrape cheapest, extract/crawl more). Check with the account tool.
use_proxy: true routes through rotating residential proxies for rate-limited or geo-blocked sites.
solve_cf: true forces Cloudflare-challenge solving (slower — use only when a page is blocked).

Built by PESARES. MIT-licensed client; the API is a paid service.