@clawfetch/mcp
MCP (Model Context Protocol) server for ClawFetch — Web Intelligence API for AI Agents.
Gives 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.
Payments are handled automatically via the x402 protocol — USDC on Base. No API keys, no billing dashboards.
☁️ Hosted Mode (Recommended)
Connect directly to the hosted MCP server — no installation required:
Endpoint: https://mcp.clawfetch.ai/mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"clawfetch": {
"type": "url",
"url": "https://mcp.clawfetch.ai/mcp"
}
}
}
Cursor / Windsurf
Add to your MCP configuration:
{
"mcpServers": {
"clawfetch": {
"url": "https://mcp.clawfetch.ai/mcp"
}
}
}
OpenClaw
mcp:
servers:
clawfetch:
url: https://mcp.clawfetch.ai/mcp
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.
💻 Self-Hosted Mode
Run your own instance with full control over the payment wallet.
Install
npm install -g @clawfetch/mcp
Add to your MCP client config (e.g., Claude Desktop):
{
"mcpServers": {
"clawfetch": {
"command": "clawfetch-mcp",
"env": {
"CLAWFETCH_PRIVATE_KEY": "0xYOUR_ETHEREUM_PRIVATE_KEY"
}
}
}
}
The private key signs x402 micropayments (USDC on Base). Fund the corresponding address with USDC on Base mainnet.
Run as HTTP Server
Expose the MCP server over HTTP for remote clients:
CLAWFETCH_PRIVATE_KEY=0x... CLAWFETCH_TRANSPORT=http CLAWFETCH_PORT=3001 clawfetch-mcp
This starts a server at http://localhost:3001/mcp using the Streamable HTTP transport (MCP spec compliant).
HTTP Endpoints
| Endpoint | Method | Description |
|---|
/mcp | POST | Initialize session — returns Mcp-Session-Id header |
/mcp | GET | SSE stream for server-to-client notifications (requires session ID) |
/mcp | DELETE | Close a session |
/health | GET | Server health check (JSON) |
Session Flow
- Initialize:
POST /mcp with JSON-RPC initialize request → get Mcp-Session-Id header
- Call tools:
POST /mcp with Mcp-Session-Id header + JSON-RPC tools/call request
- Stream:
GET /mcp?sessionId=... for SSE notifications (optional)
- Close:
DELETE /mcp with Mcp-Session-Id header
| Tool | Description | Cost |
|---|
fetch_url | Fetch any URL as clean markdown | $0.001 |
render_page | Render JS-heavy pages (SPAs, React apps) | $0.002 |
extract_data | Extract structured data from 17+ site types | $0.003 |
research_topic | Multi-source research with citations | $0.01 |
check_domains | Check domain name availability | $0.002 |
suggest_domains | Generate available domain suggestions | $0.002 |
list_extractors | List supported structured data extractors | $0.001 |
health_check | Check API health status | Free |
wallet_info | Show payment wallet address | Free |
GitHub repos/profiles, npm packages, PyPI packages, Twitter/X profiles, LinkedIn profiles/companies, YouTube videos/channels, Product Hunt, Hacker News, Reddit, Crunchbase, Wikipedia, and more.
Use list_extractors to see all available types with their schema.
Environment Variables
| Variable | Required | Default | Description |
|---|
CLAWFETCH_PRIVATE_KEY | Yes* | — | Ethereum private key (0x-prefixed) for x402 payments |
CLAWFETCH_BASE_URL | No | https://api.clawfetch.ai | API base URL |
CLAWFETCH_TRANSPORT | No | stdio | Transport: stdio or http |
CLAWFETCH_HOST | No | 0.0.0.0 | HTTP server bind address |
CLAWFETCH_PORT | No | 3001 | HTTP server port |
CLAWFETCH_TIMEOUT_MS | No | 60000 | Request timeout in ms |
CLAWFETCH_DEBUG | No | false | Enable debug logging (1 or true) |
* Required for self-hosted mode. The hosted server at mcp.clawfetch.ai manages its own wallet.
Development
git clone https://github.com/clawfetch/clawfetch-mcp.git
cd clawfetch-mcp
npm install
npm run build
npm test
License
MIT