Back to Directory/Search & Knowledge

ai.clawfetch/mcp

Web intelligence for AI agents: fetch, render, extract, research. x402 micropayments, no API keys.

Search & KnowledgeTypeScriptv0.3.2

@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

Configure (stdio — for local MCP clients)

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
EndpointMethodDescription
/mcpPOSTInitialize session — returns Mcp-Session-Id header
/mcpGETSSE stream for server-to-client notifications (requires session ID)
/mcpDELETEClose a session
/healthGETServer health check (JSON)
Session Flow
  1. Initialize: POST /mcp with JSON-RPC initialize request → get Mcp-Session-Id header
  2. Call tools: POST /mcp with Mcp-Session-Id header + JSON-RPC tools/call request
  3. Stream: GET /mcp?sessionId=... for SSE notifications (optional)
  4. Close: DELETE /mcp with Mcp-Session-Id header

Tools

ToolDescriptionCost
fetch_urlFetch any URL as clean markdown$0.001
render_pageRender JS-heavy pages (SPAs, React apps)$0.005
extract_dataExtract structured data from 17+ site types$0.008
research_topicMulti-source research with citations$0.02
check_domainsCheck domain name availability$0.008
suggest_domainsGenerate available domain suggestions$0.008
parse_documentParse office docs (docx/pptx/xlsx/pdf/…) to markdown$0.005
list_extractorsList supported structured data extractors$0.001
health_checkCheck API health statusFree
wallet_infoShow payment wallet addressFree

Supported Extractors

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

VariableRequiredDefaultDescription
CLAWFETCH_PRIVATE_KEYYes*—Ethereum private key (0x-prefixed) for x402 payments
CLAWFETCH_BASE_URLNohttps://api.clawfetch.aiAPI base URL
CLAWFETCH_TRANSPORTNostdioTransport: stdio or http
CLAWFETCH_HOSTNo0.0.0.0HTTP server bind address
CLAWFETCH_PORTNo3001HTTP server port
CLAWFETCH_TIMEOUT_MSNo60000Request timeout in ms
CLAWFETCH_DEBUGNofalseEnable 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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @clawfetch/mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@clawfetch/mcpnpm

Compatible MCP Clients

ai.clawfetch/mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More