{"_id":"@clawfetch/mcp","_rev":"5-be025b0ccd803f3d8422915e7008e8e8","name":"@clawfetch/mcp","dist-tags":{"latest":"0.3.2"},"versions":{"0.2.0":{"name":"@clawfetch/mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","ai-agent","web-intelligence","x402","clawfetch","web-scraping","structured-data","domain-check","research"],"author":{"name":"ClawFetch","email":"hello@clawfetch.ai"},"license":"MIT","_id":"@clawfetch/mcp@0.2.0","maintainers":[{"name":"michaelsteuer","email":"michael@make.services"}],"homepage":"https://clawfetch.ai","bugs":{"url":"https://github.com/clawfetch/clawfetch-mcp/issues"},"bin":{"clawfetch-mcp":"dist/index.js"},"dist":{"shasum":"dec7af0f68b85d9ede74a0cb7fee4e0fb036cdd7","tarball":"https://registry.npmjs.org/@clawfetch/mcp/-/mcp-0.2.0.tgz","fileCount":6,"integrity":"sha512-9S1fth4i1+Y7+qs/do/OEpYYA9i/qzus31ZoP/LHeO7vKcKia0uiX40Qiv2tANQn7gXriYOyiN0z9aMKqn4ZFQ==","signatures":[{"sig":"MEUCIQCLi8xDm7OVLsI8lbpmN3L+TqoYQdQPEgmsSqx3cQ8zfQIgT7Mv9uGEMXlIcWwzVQJINXO89AZh4Qp2huoG5jcLsFY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1818165},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"64016a67731b642fbeda7bb201af919e386cd08d","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsup src/index.ts --format esm --no-dts","test:watch":"vitest","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"michaelsteuer","email":"michael@make.services"},"repository":{"url":"git+https://github.com/clawfetch/clawfetch-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"MCP server for AI agents to use ClawFetch — Web Intelligence API with x402 micropayments (USDC on Base)","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^4.3.6","viem":"^2.47.6","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.28.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","vitest":"^4.1.2","typescript":"^6.0.2","@types/node":"^25.5.0","@clawfetch/sdk":"file:../clawfetch-sdk","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1785909579321_0.10047271130121538","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@clawfetch/mcp","version":"0.2.1","keywords":["mcp","model-context-protocol","ai-agent","web-intelligence","x402","clawfetch","web-scraping","structured-data","domain-check","research"],"author":{"name":"ClawFetch","email":"hello@clawfetch.ai"},"license":"MIT","_id":"@clawfetch/mcp@0.2.1","maintainers":[{"name":"michaelsteuer","email":"michael@make.services"}],"homepage":"https://clawfetch.ai","bugs":{"url":"https://github.com/clawfetch/clawfetch-mcp/issues"},"bin":{"clawfetch-mcp":"dist/index.js"},"dist":{"shasum":"4c8d8f4638aa3210ccb7eb8648ffe47a0840afca","tarball":"https://registry.npmjs.org/@clawfetch/mcp/-/mcp-0.2.1.tgz","fileCount":6,"integrity":"sha512-lMoYgNskhepKxNc+X7sIxfFEYRfP2dRVWuL8kQmGSJbWHXUH6gjCGLdF46Lr1hZ/Cz3OX8KW6uPtbMiNTGIfZw==","signatures":[{"sig":"MEQCIC/o9po8tU2g/FPGShqTPAjLVDZGCrUWuW4/7UtlPZnpAiAEZUSw3cXQ+osvRI82skDxpN1GI4hXAPCOUfWauT97EQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1818215},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"64016a67731b642fbeda7bb201af919e386cd08d","mcpName":"io.github.clawfetch/clawfetch-mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsup src/index.ts --format esm --no-dts","test:watch":"vitest","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"michaelsteuer","email":"michael@make.services"},"repository":{"url":"git+https://github.com/clawfetch/clawfetch-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"MCP server for AI agents to use ClawFetch — Web Intelligence API with x402 micropayments (USDC on Base)","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^4.3.6","viem":"^2.47.6","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.28.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","vitest":"^4.1.2","typescript":"^6.0.2","@types/node":"^25.5.0","@clawfetch/sdk":"file:../clawfetch-sdk","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.1_1785911062359_0.48895131992813234","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@clawfetch/mcp","version":"0.2.2","keywords":["mcp","model-context-protocol","ai-agent","web-intelligence","x402","clawfetch","web-scraping","structured-data","domain-check","research"],"author":{"name":"ClawFetch","email":"hello@clawfetch.ai"},"license":"MIT","_id":"@clawfetch/mcp@0.2.2","maintainers":[{"name":"michaelsteuer","email":"michael@make.services"}],"homepage":"https://clawfetch.ai","bugs":{"url":"https://github.com/clawfetch/clawfetch-mcp/issues"},"bin":{"clawfetch-mcp":"dist/index.js"},"dist":{"shasum":"75aab437cafd1a142f8ddaf4eebd89ca69a3435a","tarball":"https://registry.npmjs.org/@clawfetch/mcp/-/mcp-0.2.2.tgz","fileCount":6,"integrity":"sha512-rxFTRm2jFCBx+Er/zhYplG+ECRTrPf9huSnjhGbufnXBaIv+nVDNVG3us6s3I0/pTZ9VBQGlBxRRtKhrNleJDA==","signatures":[{"sig":"MEUCIBsTxgXXS8ZZ6u/LMuqQ3gN236Xu+BSVgcsKGotRQMwvAiEAhbTO24Vp3a16nJZmAQrn0+D08Tzsy6U48kStJoHieWU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1818198},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"d696041dc4a189073530ded7ba76487e23bfa453","mcpName":"ai.clawfetch/mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsup src/index.ts --format esm --no-dts","test:watch":"vitest","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"michaelsteuer","email":"michael@make.services"},"repository":{"url":"git+https://github.com/clawfetch/clawfetch-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"MCP server for AI agents to use ClawFetch — Web Intelligence API with x402 micropayments (USDC on Base)","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^4.3.6","viem":"^2.47.6","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.28.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","vitest":"^4.1.2","typescript":"^6.0.2","@types/node":"^25.5.0","@clawfetch/sdk":"file:../clawfetch-sdk","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.2_1785914062244_0.41434470488686914","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@clawfetch/mcp","version":"0.3.1","keywords":["mcp","model-context-protocol","ai-agent","web-intelligence","x402","clawfetch","web-scraping","structured-data","domain-check","research"],"author":{"name":"ClawFetch","email":"hello@clawfetch.ai"},"license":"MIT","_id":"@clawfetch/mcp@0.3.1","maintainers":[{"name":"michaelsteuer","email":"michael@make.services"}],"homepage":"https://clawfetch.ai","bugs":{"url":"https://github.com/clawfetch/clawfetch-mcp/issues"},"bin":{"clawfetch-mcp":"dist/index.js"},"dist":{"shasum":"2d18d09f5122a26c7e32555d6a2c78fe43fb21d7","tarball":"https://registry.npmjs.org/@clawfetch/mcp/-/mcp-0.3.1.tgz","fileCount":6,"integrity":"sha512-58zz4IhiecJEC7cyue4SEA6U7cJYQ7w95sC16aflPk+xGphklLosOSp0coxwosQMqCe30xJpolcQVqpwPXjipg==","signatures":[{"sig":"MEUCIQCg2v8ldAsNiil0e5RiqvqZjEBWKlwmGeStyMrBjOAcCwIgZwzWsx7MBGAwuGcGJGs4FJWabtOtVaFvHMYvm9eU0AQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1821784},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"1811863a11dc32fe6b04bedeca1f76e2618f9887","mcpName":"ai.clawfetch/mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsup src/index.ts --format esm --no-dts","test:watch":"vitest","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"michaelsteuer","email":"michael@make.services"},"repository":{"url":"git+https://github.com/clawfetch/clawfetch-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"MCP server for AI agents to use ClawFetch — Web Intelligence API with x402 micropayments (USDC on Base)","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^4.3.6","viem":"^2.47.6","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.28.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","vitest":"^4.1.2","typescript":"^6.0.2","@types/node":"^25.5.0","@clawfetch/sdk":"file:../clawfetch-sdk","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.1_1785999866240_0.37253390727719116","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"_id":"@clawfetch/mcp@0.3.2","bin":{"clawfetch-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/clawfetch/clawfetch-mcp/issues"},"dist":{"shasum":"f1f8012d515aa169c3d2463f409d06ccf3fd01ac","tarball":"https://registry.npmjs.org/@clawfetch/mcp/-/mcp-0.3.2.tgz","fileCount":6,"integrity":"sha512-uuujabkAajKMxDzUCw4iJ9szaHap6mewuz4a00knwlWXCJwdVX13+CudlwwWXuF1p47L7IKAfjMpF/hYa9c74g==","signatures":[{"sig":"MEUCIQCKG+iQei0700mxc8bpHGDc5dAm7Y0dyVNeaEUKcLszNAIgAO9X70xzuPlzML5kuhTOVE1rYbeoBk2MghLmG0Zt3w0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFjhPBum0KQASWdxNhNeXJoDzndrfZYr7SzrSV4dr4QpAiBQI9Ko/Ccmgwi7TOwhQPkVl1cg1iUJPUKCeHtGCbEOnQ=="}],"unpackedSize":1822567},"main":"dist/index.js","name":"@clawfetch/mcp","type":"module","author":{"name":"ClawFetch","email":"hello@clawfetch.ai"},"engines":{"node":">=18"},"gitHead":"1dea0e3987c167a7ad025cd7f89c6d4edbef8191","license":"MIT","mcpName":"ai.clawfetch/mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsup src/index.ts --format esm --no-dts","test:watch":"vitest","prepublishOnly":"npm run build && npm test"},"version":"0.3.2","_npmUser":{"name":"michaelsteuer","email":"michael@make.services"},"homepage":"https://clawfetch.ai","keywords":["mcp","model-context-protocol","ai-agent","web-intelligence","x402","clawfetch","web-scraping","structured-data","domain-check","research"],"repository":{"url":"git+https://github.com/clawfetch/clawfetch-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"MCP server for AI agents to use ClawFetch — Web Intelligence API with x402 micropayments (USDC on Base)","directories":{},"maintainers":[{"name":"michaelsteuer","email":"michael@make.services"}],"_nodeVersion":"26.7.0","dependencies":{"zod":"^4.3.6","viem":"^2.47.6","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.28.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","vitest":"^4.1.2","typescript":"^6.0.2","@types/node":"^25.5.0","@clawfetch/sdk":"file:../clawfetch-sdk","@types/express":"^5.0.6"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.3.2_1790326359843_0.8825612931990667"}}},"time":{"created":"2026-08-05T05:59:39.120Z","modified":"2026-09-25T08:52:40.154Z","0.2.0":"2026-08-05T05:59:39.468Z","0.2.1":"2026-08-05T06:24:22.514Z","0.2.2":"2026-08-05T07:14:22.431Z","0.3.1":"2026-08-06T07:04:26.492Z","0.3.2":"2026-09-25T08:52:39.973Z"},"bugs":{"url":"https://github.com/clawfetch/clawfetch-mcp/issues"},"author":{"name":"ClawFetch","email":"hello@clawfetch.ai"},"license":"MIT","homepage":"https://clawfetch.ai","keywords":["mcp","model-context-protocol","ai-agent","web-intelligence","x402","clawfetch","web-scraping","structured-data","domain-check","research"],"repository":{"url":"git+https://github.com/clawfetch/clawfetch-mcp.git","type":"git"},"description":"MCP server for AI agents to use ClawFetch — Web Intelligence API with x402 micropayments (USDC on Base)","maintainers":[{"name":"michaelsteuer","email":"michael@make.services"}],"readme":"# @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## Access and payment\n\nThe 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.\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.003 |\n| `suggest_domains` | Generate available domain suggestions | $0.003 |\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. Keep this key in your local configuration; never submit it to the ClawFetch website.\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","readmeFilename":"README.md"}