Skip to main content
All integrations

MCP & API

AdsCrawl for AdsCrawl MCP

Connect an MCP-compatible agent to AdsCrawl's hosted browser tools over Streamable HTTP. Your agent can open pages, read content and complete multi-step browser work in a shared session.

What you can do

01

Read a live page

Open a hosted browser and inspect rendered content with browser_open and browser_read.

02

Work across steps

Navigate, click and fill forms while keeping related work in one session.

03

Inspect and close

Inspect the result, optionally share a screenshot, and release the session with browser_close.

Before you start

  • An AdsCrawl account and API key.
  • An MCP client supporting Streamable HTTP and a secret x-api-key header.

SETUP METHOD 01

Remote MCP server

Use the browser tool endpoint below in your client's MCP settings.

  1. Add the remote server

    Choose Streamable HTTP as the transport. This is the browser service endpoint, separate from the documentation search MCP.

    Endpoint
    https://api.adscrawl.net/mcp
  2. Set the authentication header

    In your client's secret settings, map x-api-key to your AdsCrawl API key. Codex and Cursor also support environment-backed headers; their detail pages include exact configurations.

  3. List tools and test one page

    Connect and list tools. Verify browser_open, browser_read and browser_close, then run the prompt below. Check for confirmed: true after browser_close.

Try it

After setup, send this to your agent to check that the integration works.

Prompt
Open https://example.com with AdsCrawl, read the page heading, then close the browser. Confirm that the session has stopped.

Usage & limits

  • API requests and browser sessions use your AdsCrawl account credits. Installing a client does not include a separate usage allowance.
  • Close remote sessions after use. A disconnected client or closed viewer does not confirm that the server-side session has stopped.
  • MCP browser_screenshot creates a publicly accessible JPEG link; use it only for content you intend to share. The HTTP screenshot API and script fallback return PNG data instead.
  • Concurrent sessions share your API key's limits. A target website can still require login or deny access.
See pricing and credit conversion

Further reading

MCP server reference