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: trueif 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 (
scrapecheapest,extract/crawlmore). Check with theaccounttool. use_proxy: trueroutes through rotating residential proxies for rate-limited or geo-blocked sites.solve_cf: trueforces 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)
| File | Size | Uploaded | |
|---|---|---|---|
| bypassapi_mcp-0.1.0.tar.gz | 5.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|