webclaw/packages/webclaw-mcp
Valerio 0678f0ba14 feat(mcp): add @webclaw/mcp zero-install launcher as the canonical MCP command
`npx -y @webclaw/mcp` downloads the prebuilt webclaw-mcp binary (verified
against the release SHA256SUMS), caches it, and runs it as an MCP stdio server.
This makes webclaw introspectable in MCP registries (Glama/Smithery/MCP
registry) and installable in any MCP client with no Rust build.

- packages/webclaw-mcp: zero-dep launcher (.mjs) + package.json + README
- README/CLAUDE/examples/smithery: mcpServers config -> npx -y @webclaw/mcp
- registry: point the MCP-registry entry (server.json) at @webclaw/mcp, the
  real stdio server, instead of create-webclaw (a scaffolder); drop
  create-webclaw's mcpName claim so ownership isn't duplicated
- CHANGELOG: unreleased entry

create-webclaw stays as the auto-detect installer. .mcp.json is intentionally
left pointing at the local install path until @webclaw/mcp is published to npm.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-21 18:14:30 +02:00
..
package.json feat(mcp): add @webclaw/mcp zero-install launcher as the canonical MCP command 2026-07-21 18:14:30 +02:00
README.md feat(mcp): add @webclaw/mcp zero-install launcher as the canonical MCP command 2026-07-21 18:14:30 +02:00
webclaw-mcp.mjs feat(mcp): add @webclaw/mcp zero-install launcher as the canonical MCP command 2026-07-21 18:14:30 +02:00

@webclaw/mcp

Zero-install launcher for the webclaw MCP server — web extraction and anti-bot web access for AI agents, over the Model Context Protocol.

npx @webclaw/mcp downloads a prebuilt webclaw-mcp binary once (from the pinned GitHub release), caches it, and runs it as an MCP stdio server. No Rust build, no global install. It runs on your machine; the hosted webclaw cloud is only used for tools that need it, and only when you set WEBCLAW_API_KEY.

Use in an MCP client

Point any stdio MCP client at the npx command. Claude Desktop / Cursor / Windsurf / Antigravity (mcpServers JSON):

{
  "mcpServers": {
    "webclaw": {
      "command": "npx",
      "args": ["-y", "@webclaw/mcp"]
    }
  }
}

Add a key for cloud-backed tools (anti-bot bypass, JS rendering, search, research):

{
  "mcpServers": {
    "webclaw": {
      "command": "npx",
      "args": ["-y", "@webclaw/mcp"],
      "env": { "WEBCLAW_API_KEY": "wc_your_key" }
    }
  }
}

Claude Code:

claude mcp add webclaw -- npx -y @webclaw/mcp

Tools

scrape, search, crawl, map, batch, extract, summarize, diff, brand, research, lead, lead_batch, plus list_extractors / vertical_scrape for 30+ site-specific extractors. Local tools run with no API key; cloud tools require WEBCLAW_API_KEY.

Environment

Variable Purpose
WEBCLAW_API_KEY Enables cloud-backed tools (optional).
WEBCLAW_MCP_BIN Absolute path to a webclaw-mcp binary; skips download.
WEBCLAW_MCP_VERSION Release tag to install (default: the pinned release).
WEBCLAW_MCP_CACHE Cache directory (default: ~/.cache/webclaw).

The downloaded archive is verified against the release SHA256SUMS before use.

Alternatives

  • npx create-webclaw — interactive installer that auto-detects your AI tools and writes their configs for you.
  • Prebuilt binaries, Homebrew, Docker, and cargo install — see the main README.

License

AGPL-3.0-only