# ClawFetch MCP server

> Enables AI agents to fetch web pages as markdown, render JavaScript-heavy sites, extract structured data, and perform multi-source research.

- Repository: https://github.com/clawfetch/clawfetch-mcp
- Page: https://hostedmcp.org/servers/clawfetch/clawfetch-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.4.0

## Install

### Claude Code

```sh
claude mcp add --env 'CLAWFETCH_PRIVATE_KEY=<YOUR_CLAWFETCH_PRIVATE_KEY>' clawfetch-mcp -- npx -y @clawfetch/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "clawfetch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@clawfetch/mcp"
      ],
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "clawfetch-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@clawfetch/mcp"
      ],
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"clawfetch-mcp","type":"stdio","command":"npx","args":["-y","@clawfetch/mcp"],"env":{"CLAWFETCH_PRIVATE_KEY":"<YOUR_CLAWFETCH_PRIVATE_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "clawfetch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@clawfetch/mcp"
      ],
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add clawfetch-mcp --env 'CLAWFETCH_PRIVATE_KEY=<YOUR_CLAWFETCH_PRIVATE_KEY>' -- npx -y @clawfetch/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.clawfetch-mcp]
command = "npx"
args = ["-y", "@clawfetch/mcp"]

[mcp_servers.clawfetch-mcp.env]
CLAWFETCH_PRIVATE_KEY = "<YOUR_CLAWFETCH_PRIVATE_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'CLAWFETCH_PRIVATE_KEY=<YOUR_CLAWFETCH_PRIVATE_KEY>' clawfetch-mcp npx -- -y @clawfetch/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "clawfetch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@clawfetch/mcp"
      ],
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CLAWFETCH_PRIVATE_KEY` | yes | yes | EVM private key for a Base wallet holding USDC (pays x402 micropayments gaslessly) |

## Tools (11)

- `fetch_url`: Fetch a URL and return its content as clean markdown. Works for articles, docs, blogs, product pages — any static HTML. Cost: $0.001 per request.
- `render_page`: Render a JavaScript-heavy page using a stealth browser and return clean markdown. Use for SPAs, React/Vue/Angular apps, pages behind JS rendering. Cost: $0.005 per request.
- `research_topic`: Research a topic using multiple sources. Returns a summary with cited sources. Great for market research, competitive analysis, fact-checking, and current events. Cost: $0.02 per request.
- `check_domains`: Check if one or more domain names are available for registration. Cost: $0.003 per request.
- `suggest_domains`: Generate available domain name suggestions based on a keyword or concept. Cost: $0.003 per request.
- `extract_data`: Extract structured data from a URL using a specialized extractor. Supports 17+ site types including GitHub repos/profiles, npm packages, Twitter/X profiles, LinkedIn, YouTube, Product Hunt, Hacker News, Reddit, and more. Cost: $0.008 per request.
- `list_extractors`: List all available structured data extractors with their supported domains and fields. Use this to discover what sites ClawFetch can extract typed data from. Cost: $0.001.
- `parse_document`: Parse an office document (docx, pptx, xlsx, pdf, odt, ods, odp, rtf, epub, csv, doc, ppt) into clean GitHub-Flavored Markdown. Provide a document URL or a local file path. Deterministic Rust converter — headings, tables, and lists preserved. No OCR: scanned/image-only PDFs are rejected. Cost: $0.005 per request.
- `enrich_company`: Company enrichment from a domain: firmographic profile of a company website. Returns name, description, logo, social profiles (LinkedIn, X, GitHub, YouTube, Crunchbase and more), contact emails and phones, postal address, schema.org Organization data, detected tech stack and key pages (about, careers, pricing, docs). Deterministic parse of the live site, no LLM. Cost: $0.02 per request.
- `health_check`: Check the ClawFetch API health status. Free — no x402 payment required.
- `wallet_info`: Get the wallet address being used for x402 payments. Useful for checking balance or funding the wallet.

## FAQ

### How do I pay for tool calls?

Payments are handled automatically via the x402 protocol using USDC on the Base network. You must fund your Ethereum wallet address with USDC on Base mainnet.

### Can I run the server locally?

Yes, you can run the MCP server locally using npm and configure it with your Ethereum private key for payments.

### What kind of data can be extracted?

The server can extract structured data from over 17 site types, including GitHub, LinkedIn, Twitter, Reddit, and Wikipedia.
