Cloudflare Web Search API beta and Sume crawl tools for research
Cloudflare's Web Search API beta targets agents. Sume's hosted MCP has its own read-only crawl tools. How to research references first, then generate.
Use any search tool you like for the research step, and keep it separate from the generation step. The Cloudflare changelog lists a Web Search API beta for agents, and Sume's hosted MCP has its own read-only crawl tools, so an agent can gather references with one and spend credits with the other.
The split matters because research is cheap to repeat and generation is not. Sume's crawl read tools work under OAuth mcp:read; the paid generation tools do not.
What the changelog lists
Entries from the Oct 2 window.
| Item | What the page says |
|---|---|
| Web Search API | Beta, for agents |
| Workers KV jurisdictions | Generally available |
| Analytics | 30 days on every plan |
Sume's crawl tools
The hosted inventory lists a crawl group for web and social research. Everything except site crawling is a read tool, which is visible to a read-only OAuth session; crawl_site is a write tool, unbilled, that you follow with jobs_wait and then crawl_get on the same id. The docs also name two skills for it: crawl-web for web research and crawl-social for social discovery.
| Tool | Gate | Use |
|---|---|---|
crawl_scrape | Read | Fetch one page |
crawl_map | Read | List the pages of a site |
crawl_search | Read | Search the web |
crawl_profile, crawl_feed, crawl_media, crawl_find | Read | Social discovery |
crawl_site | Write, idempotency_key | Crawl a site as a job; unbilled utility |
crawl_get | Read | Read a crawl result |
A research-then-generate loop
Keep the stages explicit so a failure in one does not repeat the other.
- Research: collect a handful of reference pages or images with the search tool of your choice, or with
crawl_searchandcrawl_scrape. - Brief: have the agent write a short brief that names the references it used. Store it.
- Preview: call the generation tool with
dry_run=true, orgeneration_admission_preview, and report the estimate. - Generate: after confirmation, call it with a fresh
idempotency_key, then wait on the job ids.
Where references can come from
Hosted MCP cannot read files from your laptop. If a reference is a local file, the upload flow is to create an upload URL, have the client PUT the bytes, and then call assets_complete. For a social video link, the docs point to media-imports_create as the social URL mirror.
Whichever source you use, check you have the right to use the reference for the work you plan, and keep a note of where each one came from. The agent should cite its references in the brief, not paraphrase them from memory.
Do not mix the credentials
A web search API key is a different credential from a Sume key or OAuth token, and none of them belong in a prompt. An OAuth token is not a Sume API key; do not forward it to a third party, including a search provider.
If you run the loop unattended, use an API key held as a secret on the server, and keep max_spend_usd on every paid call so a bad brief cannot run up a bill.
What the beta status means
The changelog calls the search API a beta. Treat its interface as something that may change, wrap it behind one function in your agent, and keep the brief format independent of it. Then swapping the research tool, whether for a Sume crawl tool or another provider, does not change the generation step.
Sources
Related posts
More in Integrations
- Cloudflare Workers OAuth Provider 1.0: do you need it for Sume MCP?
Cloudflare shipped Workers OAuth Provider 1.0. You do not need it to use Sume's hosted MCP, which runs its own OAuth. When you would, and what Sume handles.
- Evaluating a video MCP server: five checks, with Runway as context
Runway shipped MCP and plugin channels on Sep 17, 22, 23 and Oct 1. Before you connect any video MCP server, check scopes, idempotency, spend caps and waits.
- fal lists Seedream 5.0 and Krea 2: find what Sume's image catalog has
fal.ai/models names GPT Image 2.5, Flux 2, Nano Banana 2, Ideogram 4, Krea 2 and Seedream 5.0. A Python check of which names appear in Sume's /v1/images/models.
- LangGraph interrupt or wait: resume a graph from a Sume webhook
A LangGraph interrupt is for a human decision, not a video render. Pause for approval, then resume the graph from a signed Sume webhook keyed by job_id.
Written by Sume