{
  "markdown": "# @clawfetch/mcp\n\nMCP (Model Context Protocol) server for [ClawFetch](https://clawfetch.ai) — Web Intelligence API for AI Agents.\n\nGives any MCP-compatible client (Claude Desktop, Cursor, Windsurf, OpenClaw, etc.) instant access to ClawFetch's web intelligence tools: fetch pages as markdown, render JS-heavy SPAs, extract structured data from 17+ site types, research topics multi-source, and check domain availability.\n\nPayments are handled automatically via the [x402 protocol](https://www.x402.org/) — USDC on Base. No API keys, no billing dashboards.\n\n## ☁️ Hosted Mode (Recommended)\n\nConnect directly to the hosted MCP server — no installation required:\n\n**Endpoint:** `https://mcp.clawfetch.ai/mcp`\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"clawfetch\": {\n      \"type\": \"url\",\n      \"url\": \"https://mcp.clawfetch.ai/mcp\"\n    }\n  }\n}\n```\n\n### Cursor / Windsurf\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"clawfetch\": {\n      \"url\": \"https://mcp.clawfetch.ai/mcp\"\n    }\n  }\n}\n```\n\n### OpenClaw\n\n```yaml\nmcp:\n  servers:\n    clawfetch:\n      url: https://mcp.clawfetch.ai/mcp\n```\n\n> **Note:** The hosted server handles x402 payments server-side. Tools that require payment (fetch, render, extract, research) will charge USDC on Base per call. Free tools (health_check, wallet_info, list_extractors) work without payment.\n\n## 💻 Self-Hosted Mode\n\nRun your own instance with full control over the payment wallet.\n\n### Install\n\n```bash\nnpm install -g @clawfetch/mcp\n```\n\n### Configure (stdio — for local MCP clients)\n\nAdd to your MCP client config (e.g., Claude Desktop):\n\n```json\n{\n  \"mcpServers\": {\n    \"clawfetch\": {\n      \"command\": \"clawfetch-mcp\",\n      \"env\": {\n        \"CLAWFETCH_PRIVATE_KEY\": \"0xYOUR_ETHEREUM_PRIVATE_KEY\"\n      }\n    }\n  }\n}\n```\n\nThe private key signs x402 micropayments (USDC on Base). Fund the corresponding address with USDC on Base mainnet.\n\n### Run as HTTP Server\n\nExpose the MCP server over HTTP for remote clients:\n\n```bash\nCLAWFETCH_PRIVATE_KEY=0x... CLAWFETCH_TRANSPORT=http CLAWFETCH_PORT=3001 clawfetch-mcp\n```\n\nThis starts a server at `http://localhost:3001/mcp` using the Streamable HTTP transport (MCP spec compliant).\n\n#### HTTP Endpoints\n\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `/mcp` | POST | Initialize session — returns `Mcp-Session-Id` header |\n| `/mcp` | GET | SSE stream for server-to-client notifications (requires session ID) |\n| `/mcp` | DELETE | Close a session |\n| `/health` | GET | Server health check (JSON) |\n\n#### Session Flow\n\n1. **Initialize:** `POST /mcp` with JSON-RPC `initialize` request → get `Mcp-Session-Id` header\n2. **Call tools:** `POST /mcp` with `Mcp-Session-Id` header + JSON-RPC `tools/call` request\n3. **Stream:** `GET /mcp?sessionId=...` for SSE notifications (optional)\n4. **Close:** `DELETE /mcp` with `Mcp-Session-Id` header\n\n## Tools\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `fetch_url` | Fetch any URL as clean markdown | $0.001 |\n| `render_page` | Render JS-heavy pages (SPAs, React apps) | $0.005 |\n| `extract_data` | Extract structured data from 17+ site types | $0.008 |\n| `research_topic` | Multi-source research with citations | $0.02 |\n| `check_domains` | Check domain name availability | $0.008 |\n| `suggest_domains` | Generate available domain suggestions | $0.008 |\n| `parse_document` | Parse office docs (docx/pptx/xlsx/pdf/…) to markdown | $0.005 |\n| `list_extractors` | List supported structured data extractors | $0.001 |\n| `health_check` | Check API health status | Free |\n| `wallet_info` | Show payment wallet address | Free |\n\n### Supported Extractors\n\nGitHub repos/profiles, npm packages, PyPI packages, Twitter/X profiles, LinkedIn profiles/companies, YouTube videos/channels, Product Hunt, Hacker News, Reddit, Crunchbase, Wikipedia, and more.\n\nUse `list_extractors` to see all available types with their schema.\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `CLAWFETCH_PRIVATE_KEY` | Yes* | — | Ethereum private key (0x-prefixed) for x402 payments |\n| `CLAWFETCH_BASE_URL` | No | `https://api.clawfetch.ai` | API base URL |\n| `CLAWFETCH_TRANSPORT` | No | `stdio` | Transport: `stdio` or `http` |\n| `CLAWFETCH_HOST` | No | `0.0.0.0` | HTTP server bind address |\n| `CLAWFETCH_PORT` | No | `3001` | HTTP server port |\n| `CLAWFETCH_TIMEOUT_MS` | No | `60000` | Request timeout in ms |\n| `CLAWFETCH_DEBUG` | No | `false` | Enable debug logging (`1` or `true`) |\n\n\\* Required for self-hosted mode. The hosted server at mcp.clawfetch.ai manages its own wallet.\n\n## Development\n\n```bash\ngit clone https://github.com/clawfetch/clawfetch-mcp.git\ncd clawfetch-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n## License\n\nMIT\n",
  "bytes": 4818,
  "sha": "d5dde1b5a9c65ce4236911cca8bc1985450d83ecaf36d91e6eae363567522c8e",
  "repo_slug": "clawfetch/clawfetch-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_clawfetch_mcp_5a0c0f75/readme"
}