Skip to main content

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

Sign up at bypassapi.com and copy your key (psk_live_...). New accounts include trial credits.

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.

Metadata

Release files for bypassapi-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bypassapi-mcp 0.1.0
File Size Uploaded
bypassapi_mcp-0.1.0.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bypassapi-mcp 0.1.0
File Interpreter ABI Platform
bypassapi_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.4 kB

Release files / bypassapi_mcp-0.1.0.tar.gz

Download URL bypassapi_mcp-0.1.0.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d50f256081e6405dee70731c5b6fedd89494c08002ad878f0f09b6566d86e001
BLAKE2b-256 checksum
How to use checksums
164714030619533b07eeccaa60d08e7ff19a7bccc6e35eecf64c05bfc9e2c30d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / bypassapi_mcp-0.1.0-py3-none-any.whl

Download URL bypassapi_mcp-0.1.0-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b4fcff87cc306bb799d547701284dc93b3baa14f9a8a25c0a7e2cd51d32e86d8
BLAKE2b-256 checksum
How to use checksums
b2e038724d0034aa496a00c0c37f54ecff5e0f85e86d2419cba591e2dc7b0ef4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page