DocumentationDeveloper ToolsScrapeless MCPCustom MCP Client

Custom MCP Client

Any client that speaks the Model Context Protocol can connect to Scrapeless. Use this page when your client isn’t listed under Client Setup. You’ll need your Scrapeless API token.

Option A — Stdio (spawn the server locally)

Launch scrapeless-mcp-server as a subprocess and pass the token via the environment:

{
  "command": "npx",
  "args": ["-y", "scrapeless-mcp-server"],
  "env": {
    "SCRAPELESS_KEY": "YOUR_SCRAPELESS_KEY"
  }
}

Most desktop and IDE clients accept this shape inside their mcpServers map.

Option B — Streamable HTTP (connect to the hosted endpoint)

Point your client at the hosted endpoint and authenticate with a header:

{
  "type": "streamable-http",
  "url": "https://api.scrapeless.com/mcp",
  "headers": {
    "x-api-token": "YOUR_SCRAPELESS_KEY"
  }
}

Programmatic connection (MCP SDK)

If you’re building a client with the MCP SDK, connect over Streamable HTTP:

import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
 
const transport = new StreamableHTTPClientTransport(
  new URL("https://api.scrapeless.com/mcp"),
  { requestInit: { headers: { "x-api-token": "YOUR_SCRAPELESS_KEY" } } }
)
 
const client = new Client({ name: "my-app", version: "1.0.0" })
await client.connect(transport)
 
const { tools } = await client.listTools()
console.log(tools.map(t => t.name))

Once connected, call any tool from Tools by Product. For session tuning, see Configuration.

WindsurfSDK Overview