domscout

io.github.jkresearch8Published by GitHub account jkresearch8v1.0.8Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingBrowser Automation

Overview

AI-generated overview

Local MCP server that exposes the domscout browser API so an assistant can read pages as Markdown, take screenshots, extract data, automate pages and crawl…

What you can do
  • Read pages as clean Markdown, optionally skipping the browser
  • Capture screenshots as PNG, JPEG, WebP or PDF
  • Extract named fields as typed JSON and inspect the accessibility tree and interactive elements
  • Run allowed page actions and capture the result, and run bounded allowlisted crawls
  • Poll or cancel durable jobs and batches, check credits, quota and pricing, and send feedback
  • Read API reference and OpenAPI contract resources
When to use it
Useful when an assistant needs to read or capture live web pages, pull structured fields from them, drive simple browser flows, or crawl a site within allowlists, without building its own browser stack.
Requirements
Runs locally via npx, so Node.js 20 or newer is required. A domscout API key is needed in DOMSCOUT_API_KEY for tool calls; the server starts and lists tools without one. Optional DOMSCOUT_BASE_URL and DOMSCOUT_DOCS_BASE_URL override the API and docs hosts. Network access to the domscout API is required.
Before you install
Tool calls are billed to the account that owns the key, with per-call credit costs and a cap of 10 credits per request; check credits first. The key is sent as an x-api-key header to the configured API host and should stay in the client environment block, not in prompts or commits. Page automation and crawls act on live sites, and page content is sent to a third-party service.

Installation

In SourceWeft

  1. Open domscout in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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

bash
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

json
{  "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.

Links

License

MIT. See LICENSE.

Source: README.md at commit 181213c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

4
  1. v1.0.8LatestOct 3, 2026
  2. v1.0.6Sep 23, 2026
  3. v1.0.5Sep 20, 2026
  4. v1.0.4Sep 18, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts