English Français العربية

domscout

Official registry Search and web

domscout browser API as MCP tools: screenshots, Markdown, structured data, page automation, crawls.

Source code Website 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).

NPM package @domscout/mcp
Claude Code 
claude mcp add domscout -e 'DOMSCOUT_API_KEY=<your domscout_api_key>' -e 'DOMSCOUT_BASE_URL=<DOMSCOUT_BASE_URL>' -e 'DOMSCOUT_DOCS_BASE_URL=<DOMSCOUT_DOCS_BASE_URL>' -- npx -y @domscout/mcp@1.0.8
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "domscout": {
            "command": "npx",
            "args": [
                "-y",
                "@domscout/mcp@1.0.8"
            ],
            "env": {
                "DOMSCOUT_API_KEY": "<your domscout_api_key>",
                "DOMSCOUT_BASE_URL": "<DOMSCOUT_BASE_URL>",
                "DOMSCOUT_DOCS_BASE_URL": "<DOMSCOUT_DOCS_BASE_URL>"
            }
        }
    }
}

Environment variables

  • DOMSCOUT_API_KEY secret A domscout API key from https://www.domscout.io/dashboard/api-keys. Every tool call is billed to the account that owns it.
  • DOMSCOUT_BASE_URL Override the API host. Only needed against a non-production deployment; omit it in normal use.
  • DOMSCOUT_DOCS_BASE_URL Override the host the documentation resources are read from. It cannot be derived from DOMSCOUT_BASE_URL, because the API host serves no llms-full.txt.

Documentation

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

Contents
  1. @domscout/mcp
  2. Install
  3. Tools
  4. Resources
  5. Security
  6. Links
  7. License

@domscout/mcp

Use domscout as MCP tools to read pages as Markdown, capture screenshots, extract structured data, inspect interactive structure, automate browser flows, and crawl allowlisted sites.

Install

Create an API key at https://www.domscout.io/dashboard/api-keys, then add the server to your client. Node.js 20 or newer is the only requirement; npx fetches and runs it, so there is nothing to install or build.

Claude Code

claude mcp add --transport stdio --env DOMSCOUT_API_KEY=YOUR_API_KEY domscout -- npx -y @domscout/mcp

Claude Desktop, Cursor, VS Code, and any other MCP client

{
  "mcpServers": {
    "domscout": {
      "command": "npx",
      "args": ["-y", "@domscout/mcp"],
      "env": {
        "DOMSCOUT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

One-click install buttons for Cursor and VS Code are on the documentation page.

Environment
VariableRequiredPurpose
DOMSCOUT_API_KEYFor tool callsYour API key. The server starts and lists its tools without one; every tool call needs it.
DOMSCOUT_BASE_URLNoOverrides the current production gateway for an intentionally separate deployment.
DOMSCOUT_DOCS_BASE_URLNoWhere the contract resources (/llms-full.txt, /openapi.json) are fetched from. Separate from DOMSCOUT_BASE_URL because the docs are served by the marketing site, not the API gateway, and that host has no /llms-full.txt. Defaults to https://www.domscout.io.

The default targets https://api.domscout.io. API requests do not follow redirects, so the key is never re-sent to another URL: a DOMSCOUT_BASE_URL that answers with a redirect fails with an error naming the status. Point it at the final URL instead. Verify the key in the dashboard before connecting a client; never commit or paste the key into prompts.

Tools

ToolCostWhat it does
domscout_check_creditsfreeBalance, quota, rate limit, and price list
domscout_extract_markdown1Read a page as clean Markdown (fast:true skips the browser)
domscout_capture_screenshot1–3Capture PNG/JPEG/WebP/PDF
domscout_extract_data2Extract named fields as typed JSON
domscout_inspect_page2Read the accessibility tree and interactive elements
domscout_automate_page1–2Run allowed actions and capture the result
domscout_crawl_site1/pageRun a bounded, allowlisted, robots-respecting crawl
domscout_get_jobfreePoll a durable job, batch, or crawl
domscout_cancel_jobfreeCancel one durable job
domscout_send_feedbackfreeSend product feedback

A request never costs more than 10 credits. Tool results include the request cost and remaining balance.

Completed screenshot, grid, skeleton and timeline jobs return images as MCP image blocks. PDF results use the same inline size limit for synchronous captures and completed jobs; larger PDFs return metadata and retrieval guidance. Job status and identifiers remain available alongside the capture result.

Resources

URIContents
domscout://docsAPI reference
domscout://openapiOpenAPI 3.1 contract

Security

The MCP server sends an x-api-key to the configured API host and reads the response. It has no browser, database, or billing credential. Keep the key in the MCP client environment block; do not commit it or paste it into prompts.

License

MIT. See LICENSE.

Frequently asked questions

What is domscout?

domscout browser API as MCP tools: screenshots, Markdown, structured data, page automation, crawls.

How do I install domscout?

It runs on your machine. In Claude Code: claude mcp add domscout -e 'DOMSCOUT_API_KEY=<your domscout_api_key>' -e 'DOMSCOUT_BASE_URL=<DOMSCOUT_BASE_URL>' -e 'DOMSCOUT_DOCS_BASE_URL=<DOMSCOUT_DOCS_BASE_URL>' -- npx -y @domscout/mcp@1.0.8. For other clients, paste the JSON configuration from this page into their MCP settings.

Does domscout need an API key?

Yes. It expects DOMSCOUT_API_KEY, which you set in its configuration.

Is domscout open source?

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

Who maintains domscout?

It is published by jkresearch8. 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.