Adding a Custom Clean Web-Reader Tool to Claude & Cursor via MCP
Stop pasting messy web pages into your AI editor manually — wire a reusable MCP web-reader config in under 2 minutes.
Why this breaks in production
Developers constantly switch between browser docs, GitHub issues, and their AI IDE, copying paragraphs by hand because built-in web fetchers either fail on cookie walls or dump noisy HTML into the chat.
With CleanSnap's auto-generated MCP Server configuration, your assistant fetches clean Markdown, headings, and canonical links on demand.
Recommended Engineering Approach
Open the CleanSnap Playground and select your defaults
Toggle `Strip Cookie Banners` and `Strip Nav & Footer` to match how you want your IDE assistant to read docs.
Switch to the `MCP Server Config` code tab and copy
The snippet automatically syncs your exact flags into the MCP environment block.
Restart Cursor or Claude Desktop and test with a docs URL
Ask your agent: 'Read https://docs.example.com/api and write a typed TypeScript client for it.'
Working Code Example
{
"mcpServers": {
"cleansnap": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://usecleansnap.com/api/v1/extract"],
"env": {
"CLEANSNAP_STRIP_COOKIES": "true",
"CLEANSNAP_STRIP_NAV": "true",
"CLEANSNAP_INCLUDE_METADATA": "true",
"CLEANSNAP_MAX_CHARS": "18000"
}
}
}
}Test this workflow in the CleanSnap Playground
Pre-load the Sample Docs Page or paste your own URL to inspect clean Markdown, token savings, and auto-generated cURL / Node / Python / MCP code.
Common Edge Cases & Pitfalls
- Forgetting to restart Claude Desktop after editing `claude_desktop_config.json` leaves the new server unloaded.
- Invalid trailing commas in JSON config files silently prevent MCP servers from initializing — always validate JSON syntax.
- Avoid setting `CLEANSNAP_MAX_CHARS` to 100,000+ in interactive IDE chats or a single doc page will crowd out your codebase context.
Frequently Asked Questions
Does the CleanSnap Playground generate this MCP config automatically?
Yes — click the 'MCP Server Config' tab right below the Playground output to copy a live-synced JSON snippet.
Can I use CleanSnap inside Antigravity or Windsurf as well?
Yes — any IDE or agent runner supporting standard `mcpServers` JSON blocks works seamlessly.
Is authentication required to try the Playground endpoint?
No login is required to start testing; free tier requests include transparent `X-RateLimit-Remaining` headers.