# WebCrawlerAPI — MCP server on mcp.ai
> Connect your WebCrawlerAPI account and use 10 tools for web scraping straight from your AI agent. Connect with your own API key. WebCrawlerAPI provides crawling, page scraping, AI web agents, and monitored website feeds through a unified API.

By: mcp.ai · official
Page: https://mcp.ai/webcrawlerapi

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_webcrawlerapi?ms=1787291460000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/webcrawlerapi/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/webcrawlerapi/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/webcrawlerapi/skill.md
Postman collection (v2.1): https://mcp.ai/webcrawlerapi/postman.json

## Tools
- webcrawlerapi_create_crawl(url: string, max_age?: integer, max_depth?: integer, items_limit?: integer, webhook_url?: string, output_formats?: string[], blacklist_regexp?: string, whitelist_regexp?: string, keep_query_params?: boolean, main_content_only?: boolean, respect_robots_txt?: boolean) — Start a metered asynchronous crawl over a site and return its job ID. The crawl may visit and charge for up to items_limit pages; use GET_CRAWL_JOB to monitor it.
- webcrawlerapi_create_feed(url: string, name?: string, max_depth?: integer, items_limit?: integer, webhook_url?: string, output_format?: string, include_errors?: boolean, blacklist_regexp?: string, whitelist_regexp?: string, main_content_only?: boolean, respect_robots_txt?: boolean) — Create a recurring website-change feed. Creation immediately schedules an initial crawl that may consume metered credits, and future scheduled runs may also consume credits; delete the feed when it is
- webcrawlerapi_delete_feed(feed_id: string) — Permanently cancel a feed so it cannot be resumed. The feed is removed from feed listings, but retained history may remain directly readable for 30 days.
- webcrawlerapi_get_crawl_job(crawl_id: string) — Get a crawl job's status, configuration, per-page results, content URLs, errors, and observed costs. Respect recommended_pull_delay_ms when polling.
- webcrawlerapi_get_feed(feed_id: string) — Get one feed's configuration, lifecycle status, and recent run history, including per-run crawl counts and cost. Canceled feeds remain directly readable while retained by the provider.
- webcrawlerapi_get_organization_costs(to_date?: string, from_date?: string, include_daily?: boolean) — Return current spendable balance plus request count and USD usage for a date range. The connected API key is used for both organization routes.
- webcrawlerapi_list_feed_changes(feed_id: string, page_size?: integer, next_cursor?: string) — Return one page of detected feed changes as structured JSON, with an opaque continuation cursor for older pages.
- webcrawlerapi_list_feeds() — List active and paused feeds for the connected organization, newest first. Logically canceled feeds are omitted.
- webcrawlerapi_scrape_page(url: string, prompt?: string, max_age?: integer, output_formats?: string[], clean_selectors?: string, response_schema?: object, keep_query_params?: boolean, main_content_only?: boolean, respect_robots_txt?: boolean) — Scrape one web page synchronously and return requested content or structured extraction. This consumes metered credits; supplying a prompt adds $0.002 per request.
- webcrawlerapi_set_feed_state(feed_id: string, desired_state: string) — Pause an active feed's future scheduled runs or resume a paused feed. Pausing does not stop a run that has already started, and resuming schedules future crawls that may consume metered credits.

## Example prompts
- "What can I do in WebCrawlerAPI?"
- "Show me a summary of my WebCrawlerAPI account"

## Links
Docs: https://mcp.ai/docs/mcps/webcrawlerapi
Website: https://mcp.ai/mcps/webcrawlerapi