WellMarked MCP Server

Extract web pages, search the web, and follow bulk or crawl jobs through WellMarked’s local package or hosted OAuth connection.

Local + remotestdiostreamable-httpMIT

What is the WellMarked MCP Server?

WellMarked brings web extraction into an MCP conversation. You can read a known page, search for relevant pages, or collect a larger set without passing raw HTML between tools.

Choose the operation

Use extract for one URL and search when you need to find sources first. bulk processes a supplied list of URLs; crawl explores a site from a starting page. For asynchronous work, get_job checks progress and wait_for_job waits for the result. get_usage shows the account’s remaining quota.

Local or hosted setup

The local wellmarked-mcp npm package uses stdio and a WELLMARKED_API_KEY. The hosted endpoint at https://mcp.wellmarked.io uses Streamable HTTP and browser-based OAuth sign-in. Choose the connection your client supports; the hosted route does not require copying a local API key.

Limits that affect a task

Crawling, JavaScript rendering, output formats and batch sizes depend on the WellMarked plan. Check those limits before starting a large collection. Inspect each result’s completion and error fields instead of treating an accepted job as a finished crawl.

Maintainer documentation · WellMarked MCP guide.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
extractRead one URL and return its main content as Markdown with metadata.
bulkExtract a supplied batch of URLs. Batch size depends on the account plan.
crawlExplore a site from a starting URL and return an asynchronous crawl job.
searchFind web pages and return their extracted content. Result limits depend on the account plan.
get_jobCheck the progress and results of a bulk extraction or crawl job.
wait_for_jobWait for a job to finish and return its results.
get_usageCheck the account plan, used quota, limit and remaining allowance.

How to install the WellMarked MCP Server

{
  "mcpServers": {
    "wellmarked": {
      "command": "npx",
      "args": [
        "-y",
        "wellmarked-mcp"
      ],
      "env": {
        "WELLMARKED_API_KEY": "YOUR_WELLMARKED_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Local: an environment that can run npx and a WellMarked API key. Hosted: a remote MCP client with OAuth support and a WellMarked account.

VariableDescriptionRequired
WELLMARKED_API_KEYAPI key for the local stdio connection.Yes