Enables AI agents to fetch web pages as markdown, render JavaScript-heavy sites, extract structured data, and perform multi-source research.
Also known as clawfetch/clawfetch-mcp, clawfetch-mcp, @clawfetch/mcp
- Stars
- 0
- Tools
- 11
- Downloads, 30 days
- 655
- Latest version
- 0.4.0
- Last commit
- Oct 21, 2026
- License
- MIT
What is ClawFetch MCP?
ClawFetch enables AI agents to fetch web pages as markdown, render JavaScript-heavy sites, extract structured data, and perform multi-source research. It exposes 11 tools, such as fetch_url, render_page, research_topic.
Summary generated from the project's README
About ClawFetch MCP server
Fetching web content as markdown and performing multi-source research is what this server enables for AI agents using clients like Claude Desktop, Cursor, or Windsurf. It provides specialized tools to render JavaScript-heavy single-page applications, extract structured data from over 17 site types, and enrich company profiles using a domain name. Developers can also use it to parse office documents like PDFs or spreadsheets into markdown format.
Users run this server locally via stdio or as an HTTP server. Instead of traditional API keys or billing dashboards, it uses the x402 protocol to handle micropayments via USDC on the Base network. To use the paid tools, you must provide an Ethereum private key in your configuration to sign transactions from a funded wallet. This setup ensures you maintain full control over your payment wallet while accessing web intelligence capabilities.
Written from the project's README. Every use case is checked against a quote from it.
How to install ClawFetch MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ClawFetch MCP in Claude Code
$ claude mcp add --env 'CLAWFETCH_PRIVATE_KEY=<YOUR_CLAWFETCH_PRIVATE_KEY>' clawfetch-mcp -- npx -y @clawfetch/mcpInstall ClawFetch MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"clawfetch-mcp": {
"command": "npx",
"args": [
"-y",
"@clawfetch/mcp"
],
"env": {
"CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
}
}
}
}Install ClawFetch MCP in VS Code
.vscode/mcp.json
{
"servers": {
"clawfetch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawfetch/mcp"
],
"env": {
"CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
}
}
}
}Install ClawFetch MCP in VS Code CLI
$ code --add-mcp '{"name":"clawfetch-mcp","type":"stdio","command":"npx","args":["-y","@clawfetch/mcp"],"env":{"CLAWFETCH_PRIVATE_KEY":"<YOUR_CLAWFETCH_PRIVATE_KEY>"}}'Install ClawFetch MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"clawfetch-mcp": {
"command": "npx",
"args": [
"-y",
"@clawfetch/mcp"
],
"env": {
"CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
}
}
}
}Install ClawFetch MCP in Codex
$ codex mcp add clawfetch-mcp --env 'CLAWFETCH_PRIVATE_KEY=<YOUR_CLAWFETCH_PRIVATE_KEY>' -- npx -y @clawfetch/mcpInstall ClawFetch MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.clawfetch-mcp] command = "npx" args = ["-y", "@clawfetch/mcp"] [mcp_servers.clawfetch-mcp.env] CLAWFETCH_PRIVATE_KEY = "<YOUR_CLAWFETCH_PRIVATE_KEY>"
Install ClawFetch MCP in Gemini CLI
$ gemini mcp add -s user -e 'CLAWFETCH_PRIVATE_KEY=<YOUR_CLAWFETCH_PRIVATE_KEY>' clawfetch-mcp npx -- -y @clawfetch/mcpInstall ClawFetch MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"clawfetch-mcp": {
"command": "npx",
"args": [
"-y",
"@clawfetch/mcp"
],
"env": {
"CLAWFETCH_PRIVATE_KEY": "<YOUR_CLAWFETCH_PRIVATE_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @clawfetch/mcp 0.4.0 in an isolated container with no network and no keys. It answered and listed 11 tools.
ClawFetch MCP tools 11
Read from the server with tools/listfetch_urlFetch 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_pageRender 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_topicResearch 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_domainsCheck if one or more domain names are available for registration. Cost: $0.003 per request.
suggest_domainsGenerate available domain name suggestions based on a keyword or concept. Cost: $0.003 per request.
extract_dataExtract 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_extractorsList 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_documentParse 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_companyCompany 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_checkCheck the ClawFetch API health status. Free — no x402 payment required.
wallet_infoGet the wallet address being used for x402 payments. Useful for checking balance or funding the wallet.
Configuration
CLAWFETCH_PRIVATE_KEYRequiredSecretEVM private key for a Base wallet holding USDC (pays x402 micropayments gaslessly)
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableclawfetch/clawfetch-mcp is public and reachablegithub.com/clawfetch/clawfetch-mcp ↗Pass
- Package names this repository as its source@clawfetch/mcp names clawfetch/clawfetch-mcp as sourcenpmjs.com/package/@clawfetch/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-21github.com/clawfetch/clawfetch-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @clawfetch/mcpPass
- No critical advisory in the package or its dependencies112 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@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, enrich companies from a domain, and check domain availability.
Payments are handled automatically via the x402 protocol — USDC on Base. No API keys, no billing dashboards.
Access and payment
The public hosted MCP endpoint is retired and returns HTTP 410 Gone. Run the MCP locally using the setup below, or call https://api.clawfetch.ai directly. Paid tool calls use your own USDC-funded wallet on Base; ClawFetch does not subsidize requests.
💻 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). By default it binds to 127.0.0.1 and accepts only loopback Host headers, which blocks DNS-rebinding attacks from web pages. To serve remote clients, set CLAWFETCH_HOST=0.0.0.0 and list your public hostnames in CLAWFETCH_ALLOWED_HOSTS.
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 /mcpwith JSON-RPCinitializerequest → getMcp-Session-Idheader - Call tools:
POST /mcpwithMcp-Session-Idheader + JSON-RPCtools/callrequest - Stream:
GET /mcp?sessionId=...for SSE notifications (optional) - Close:
DELETE /mcpwithMcp-Session-Idheader
Tools
| Tool | Description | Cost |
|---|---|---|
fetch_url |
Fetch any URL as clean markdown | $0.001 |
render_page |
Render JS-heavy pages (SPAs, React apps) | $0.005 |
extract_data |
Extract structured data from 17+ site types | $0.008 |
research_topic |
Multi-source research with citations | $0.02 |
check_domains |
Check domain name availability | $0.003 |
suggest_domains |
Generate available domain suggestions | $0.003 |
parse_document |
Parse office docs (docx/pptx/xlsx/pdf/…) to markdown | $0.005 |
enrich_company |
Company profile from a domain: socials, emails, tech stack, key pages | $0.02 |
list_extractors |
List supported structured data extractors | $0.001 |
health_check |
Check API health status | Free |
wallet_info |
Show payment wallet address | Free |
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
| 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 | 127.0.0.1 |
HTTP server bind address |
CLAWFETCH_ALLOWED_HOSTS |
No | localhost,127.0.0.1,[::1] |
Comma-separated Host header allowlist for the HTTP transport (DNS-rebinding protection) |
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 tool calls. Without it the server still starts and lists its tools, resources and prompts (so registries can inspect it), and every call returns setup instructions. Keep this key in your local configuration; never submit it to the ClawFetch website.
Development
git clone https://github.com/clawfetch/clawfetch-mcp.git
cd clawfetch-mcp
npm install
npm run build
npm test
License
MIT
ClawFetch MCP questions
How do I add ClawFetch MCP to Claude Code?
Run claude mcp add --env 'CLAWFETCH_PRIVATE_KEY=<YOUR_CLAWFETCH_PRIVATE_KEY>' clawfetch-mcp -- npx -y @clawfetch/mcp in your terminal. Add --scope user to make it available in every project.
How do I add ClawFetch MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ClawFetch MCP provide?
It exposes 11 tools, including fetch_url, render_page, research_topic, check_domains, suggest_domains.
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.