Docs / Guide

MCP Tools

Tools

Tools are schema-validated actions the agent can call. API keys are never accepted as tool input.

Search and scrape

ToolRequired inputLimits and defaults
datablue_search_googlequery1-100 results, 1-5 pages; country us, language en, Lite mode by default
datablue_scrape_urlurlMarkdown by default; supports HTML, links, screenshots, selectors, extraction, waits, and proxy routing
datablue_batch_scrapeurls1-20 URLs with one shared scrape configuration
datablue_extracturls, prompt1-20 URLs; prompt up to 10,000 characters; optional JSON Schema, provider, and model

Discovery and jobs

ToolRequired inputLimits and defaults
datablue_map_siteurl1-1000 links; optional search filter; subdomains and sitemap enabled by default
datablue_start_crawlurl1-1000 pages, depth 1-10, concurrency 1-10; returns a job ID
datablue_get_job_statusjob_idjob_type is crawl, search, or data
datablue_get_result_itemsresult_idRead 1-100 cached rows with offset, optional object path, and optional field projection; zero DataBlue credits

Data APIs

ToolUse
datablue_list_data_apisCall without arguments for all stable API IDs and compact parameter schemas. Pass api for one API's full descriptions, example, limits, and live credit weight. Catalog reads use zero credits.
datablue_run_data_apiRun one API ID returned by the catalog with a params object.
Example
{ "api": "zepto_products" }

Unpublished or SDK-only IDs are rejected. Poll an asynchronous Data API with datablue_get_job_status and job_type: "data".

Example agent request

Example
Search Google for "DataBlue web scraping", scrape the first three organic results as Markdown, and extract each product name and source URL.