CleanSnapv1 API
Beginner·5 min read·Topic: claude cursor mcp custom web tool

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

1

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.

2

Switch to the `MCP Server Config` code tab and copy

The snippet automatically syncs your exact flags into the MCP environment block.

3

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

cursor-mcp.jsonjson
{
  "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"
      }
    }
  }
}
TRY IT LIVE — ZERO LOGIN

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.

Run Sample Docs Page

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.

Related Developer Guides