Skip to main content

web-mcp-tools

Lint Tests Coverage CI PyPI GHCR Tags

Standalone MCP server and Python package for Firecrawl-backed web fetching with optional browser-cookie request headers.

Install

uv sync --extra dev

Configuration

  • FIRECRAWL_BASE_URL: Firecrawl API base URL.
  • FIRECRAWL_API_KEY or FIRECRAWL_API_KEY_FILE: Firecrawl API credential.
  • WEB_MCP_TOOLS_COOKIES_FROM_BROWSER: Optional browser selector for authenticated fetches, for example safari or safari:/path/to/Cookies.binarycookies.
  • WEB_MCP_TOOLS_COOKIES_MODE: off, best_effort, or required.
  • WEB_MCP_TOOLS_HOST: HTTP bind host for MCP HTTP transports.
  • WEB_MCP_TOOLS_PORT: HTTP bind port for MCP HTTP transports.
  • WEB_MCP_TOOLS_STREAMABLE_HTTP_PATH: Streamable HTTP endpoint path. Defaults to /mcp.

Run

Run over stdio:

uv run web-mcp-tools mcp

Run over Streamable HTTP:

uv run web-mcp-tools mcp --transport streamable-http --host 0.0.0.0 --port 8000

The HTTP server exposes health probes at /health and /healthz, and the default Streamable HTTP MCP endpoint at /mcp.

Compatibility health-only server:

uv run web-mcp-tools serve --host 127.0.0.1 --port 8000

Build

uv build

Test

uv run pytest

Metadata

Release files for web-mcp-tools 0.0.5

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

Source distribution (sdist)

Source distribution for web-mcp-tools 0.0.5
File Size Uploaded
web_mcp_tools-0.0.5.tar.gz 13.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for web-mcp-tools 0.0.5
File Interpreter ABI Platform
web_mcp_tools-0.0.5-py3-none-any.whl Python 3 none any Details

Total release size: 31.3 kB

Release files / web_mcp_tools-0.0.5.tar.gz

Download URL web_mcp_tools-0.0.5.tar.gz
Size 13.4 kB
Tags Source
SHA-256 checksum
How to use checksums
b532fce302332cd5061c981e261bdfc228a549d17927f9949f16eca6132b8100
BLAKE2b-256 checksum
How to use checksums
6878893b0bec336a5e030abf0db69670f4c00b6471fe0bff6d95e638fe0b7ae5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / web_mcp_tools-0.0.5-py3-none-any.whl

Download URL web_mcp_tools-0.0.5-py3-none-any.whl
Size 17.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2589b5c6365ebab4090b4fcd6722fa1e98d2c652dffccd133aa92a5bb3f2384d
BLAKE2b-256 checksum
How to use checksums
641cf72a7a03b4d5f68ffca9b4325cbbaa82c6ff5e04a10bee2d9ad50f8dc0be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.0.5 This release

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

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