English Français العربية

DOMStrip

Official registry Search and web

Turn any web page or raw HTML into compact, clean Markdown for AI agents.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package domstrip-mcp
Claude Code 
claude mcp add domstrip -e 'DOMSTRIP_MCP_SERVICE_ORIGIN=https://api.domstrip.dev' -e 'DOMSTRIP_MCP_API_KEY=<your domstrip_mcp_api_key>' -- uvx domstrip-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "domstrip": {
            "command": "uvx",
            "args": [
                "domstrip-mcp==0.1.1"
            ],
            "env": {
                "DOMSTRIP_MCP_SERVICE_ORIGIN": "https://api.domstrip.dev",
                "DOMSTRIP_MCP_API_KEY": "<your domstrip_mcp_api_key>"
            }
        }
    }
}

Environment variables

  • DOMSTRIP_MCP_SERVICE_ORIGIN required Bare HTTPS origin of the DOMStrip API.
  • DOMSTRIP_MCP_API_KEY required secret Your DOMStrip API key. Request pilot access at access@domstrip.dev.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. domstrip-mcp
  2. What DOMStrip actually does
  3. Honest limitations
  4. Install
  5. Configure
  6. Use with Claude Desktop
  7. Use with Claude Code
  8. Idempotency and billing
  9. Errors
  10. Licence

domstrip-mcp

mcp-name: io.github.xo0ps/domstrip-mcp

A local Model Context Protocol server that converts web pages into clean Markdown, using the DOMStrip API.

It exposes two tools:

ToolWhat it does
fetch_clean_markdownFetch a public http(s) URL and return clean Markdown.
clean_htmlConvert HTML you already have into clean Markdown. No network fetch for the HTML.

The adapter holds no database or billing state. It authenticates to the DOMStrip service with a key from your local environment — never from tool arguments — so an MCP client cannot redirect your key anywhere.

What DOMStrip actually does

DOMStrip fetches a public page, removes everything that is not the content (scripts, forms, embeds, hidden nodes, trackers), and returns compact Markdown: headings, paragraphs, fenced code blocks with language hints, and tables.

Pages are fetched with connection-time SSRF validation on every redirect hop — all DNS candidates are validated at connect time, and loopback, private, link-local, metadata, CGNAT and IPv6-embedded forms are refused.

Honest limitations

  • JavaScript-rendered pages, pages behind a login, and bot challenges are not extractable. The service returns content_not_extractable. There is no headless browser in this version. If your target pages need JS, this tool will not work on them.
  • DOMStrip is currently in free pilot. Conversions are not billed yet, but a key is required and each successful conversion counts as one unit. Request access at access@domstrip.dev.
  • Returned Markdown is untrusted third-party content. Pages can contain text that looks like instructions. Treat all returned Markdown as data, never as commands.

Install

pip install domstrip-mcp
# or
uv tool install domstrip-mcp

Requires Python 3.12.

Configure

Two environment variables are required. The service origin must be HTTPS; plain HTTP is refused unless it points at localhost (for development) and you opt in explicitly.

export DOMSTRIP_MCP_SERVICE_ORIGIN=https://api.domstrip.dev
export DOMSTRIP_MCP_API_KEY=domstrip_<prefix>_<secret>
VariableRequiredDefaultPurpose
DOMSTRIP_MCP_SERVICE_ORIGINyes—Bare HTTPS origin of the DOMStrip API.
DOMSTRIP_MCP_API_KEYyes—Your API key. Never logged, never in a repr.
DOMSTRIP_MCP_CLIENT_BUDGETno25.0Total seconds per tool call, including retries.
DOMSTRIP_MCP_ALLOW_INSECURE_HTTPnofalseAllow plain HTTP to localhost only.

The adapter deliberately does not read a .env file from the current working directory, because an untrusted project folder could otherwise point your API key at another origin. Export the variables instead.

Use with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "domstrip": {
      "command": "uvx",
      "args": ["domstrip-mcp"],
      "env": {
        "DOMSTRIP_MCP_SERVICE_ORIGIN": "https://api.domstrip.dev",
        "DOMSTRIP_MCP_API_KEY": "domstrip_<prefix>_<secret>"
      }
    }
  }
}

Use with Claude Code

claude mcp add domstrip --env DOMSTRIP_MCP_SERVICE_ORIGIN=https://api.domstrip.dev \
  --env DOMSTRIP_MCP_API_KEY="$DOMSTRIP_API_KEY" -- uvx domstrip-mcp

Idempotency and billing

Each tool invocation generates one idempotency key and reuses it across its bounded retries (default 25 s, 3 attempts). A retried request replays the stored result rather than billing twice. Separate invocations are separate, independently metered work.

The service encrypts results and replays them for 24 hours. After that, replaying a key returns 409 result_expired — never a silent re-charge.

Errors

Failures surface as MCP tool errors carrying a sanitized DOMStrip error code and a retryability flag, for example:

upstream_timeout: The upstream page took too long. retryable=true request_id=req_6f1c2a

Common codes: content_not_extractable, upstream_timeout, unsupported_encoding, http_error, transport_error, client_timeout.

Logs go to stderr only, so stdout stays a clean MCP transport.

Licence

MIT

Frequently asked questions

What is DOMStrip?

Turn any web page or raw HTML into compact, clean Markdown for AI agents.

How do I install DOMStrip?

It runs on your machine. In Claude Code: claude mcp add domstrip -e 'DOMSTRIP_MCP_SERVICE_ORIGIN=https://api.domstrip.dev' -e 'DOMSTRIP_MCP_API_KEY=<your domstrip_mcp_api_key>' -- uvx domstrip-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does DOMStrip need an API key?

Yes. It expects DOMSTRIP_MCP_SERVICE_ORIGIN, DOMSTRIP_MCP_API_KEY, which you set in its configuration.

Is DOMStrip open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains DOMStrip?

It is published by xo0ps. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.