Skip to main content

SteadyFetch

Reliable web fetching for AI agents. Stop losing hours to Cloudflare blocks, timeouts, and flaky scrapes.

SteadyFetch is an MCP server that gives your AI agents reliable web access with automatic retry, circuit breaker protection, caching, and anti-bot bypass — out of the box.

The Problem

Every AI agent that touches the web hits the same wall:

  • Cloudflare blocks your requests
  • Sites return CAPTCHAs
  • Pages timeout or load partially
  • Rate limits kill your batch jobs
  • You waste hours debugging flaky scrapes

The Solution

One MCP tool call. SteadyFetch handles the rest.

Agent calls fetch_url("https://example.com")
  → Checks cache (instant if hit)
  → Checks circuit breaker (fail-fast if domain is down)
  → Stealth browser fetch with anti-bot bypass
  → On failure: retry with exponential backoff
  → Fallback: plain HTTP fetch
  → Cache the result
  → Return clean markdown + raw HTML

Tools

Tool Description
fetch_url Full reliability fetch — returns markdown + HTML
fetch_markdown Returns only clean markdown, optimized for LLMs
check_domain Circuit breaker status for a domain
cache_stats Cache utilization metrics
clear_cache Flush the cache for fresh data

Quick Start

As MCP Server (remote)

Connect to the hosted server:

{
  "mcpServers": {
    "steadyfetch": {
      "url": "https://your-steadyfetch-instance.up.railway.app/mcp"
    }
  }
}

Self-hosted

pip install steadyfetch
steadyfetch

Or with Docker:

docker build -t steadyfetch .
docker run -p 8200:8200 steadyfetch

Configuration

All settings via environment variables:

Variable Default Description
PORT 8200 Server port
STEADYFETCH_MAX_RETRIES 3 Retry attempts per URL
STEADYFETCH_CIRCUIT_THRESHOLD 5 Failures before circuit opens
STEADYFETCH_CIRCUIT_COOLDOWN 120 Seconds before retrying a broken domain
STEADYFETCH_CACHE_TTL 3600 Cache lifetime in seconds
STEADYFETCH_TIMEOUT 30000 Page load timeout in ms

How It Works

Retry with backoff — Exponential backoff + jitter prevents retry storms. 3 browser attempts before falling back to HTTP.

Circuit breaker — Per-domain failure tracking. After 5 consecutive failures, the domain is circuit-broken for 2 minutes. Prevents wasting time on sites that are blocking you.

Caching — Disk-backed cache with configurable TTL. Repeat fetches are instant. 500MB default limit.

Anti-bot bypass — Stealth browser with magic mode, navigator patching, and human-like behavior simulation via Crawl4AI.

Graceful degradation — If the browser can't get through, falls back to plain HTTP. If HTTP fails, returns a clear error with domain health status. Never hangs, never silently fails.

License

MIT

Metadata

Release files for steadyfetch 0.1.1

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

Source distribution (sdist)

Source distribution for steadyfetch 0.1.1
File Size Uploaded
steadyfetch-0.1.1.tar.gz 10.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for steadyfetch 0.1.1
File Interpreter ABI Platform
steadyfetch-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 22.0 kB

Release files / steadyfetch-0.1.1.tar.gz

Download URL steadyfetch-0.1.1.tar.gz
Size 10.5 kB
Tags Source
SHA-256 checksum
How to use checksums
c3a8a25255dcc35cc6fde2054536851b8b4ee181040f103172d9e25f93181e4e
BLAKE2b-256 checksum
How to use checksums
085150403c326e09aa7c455ffc9e3c559327328872b1d38fad5c63630a4536f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release files / steadyfetch-0.1.1-py3-none-any.whl

Download URL steadyfetch-0.1.1-py3-none-any.whl
Size 11.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f627a239a14cd57e6414fb04f13151540ca80777c2fee898b3034d277fc2ce5
BLAKE2b-256 checksum
How to use checksums
22cd6c3dd5218a2bcf513edfebe68255ac88db080a2cee86685ac641ddcc3f93
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

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