Skip to the page
Get started free

SpecStream for Stirrup

SpecStream is the live web data engine for teams and agents. Pass a SpecStream Tool in the Agent's tools argument and Stirrup's web_search runs on the SpecStream Search API, with no BRAVE_API_KEY. Pages read through the Extract API, and the MCP server adds Deep Search.

Read the guide

What you get

Same tool name, same XML
The tool is named web_search and returns title, URL and description for each result, as Stirrup's Brave tool does, plus the answer and its page when the question has one.
Pages that refuse a plain read
read_pages sends up to 20 URLs to the Extract API. A page that blocks a plain request is tried in a real browser, from the site's feed, then from its archive capture.
Deep Search over MCP
MCPToolProvider connects to https://api.specstream.ai/mcp with your key as a header, and the agent can ask for every match on the live web as rows.

Set it up

  1. Create a SpecStream API key under Agents & API, set it as SPECSTREAM_API_KEY, and leave BRAVE_API_KEY unset.
  2. Save the web_search Tool from the guide in specstream_tools.py. It calls POST /v1/web-search with httpx.
  3. Pass tools=[LocalCodeExecToolProvider(), WebToolProvider(), WEB_SEARCH_TOOL] to Agent and run the session.

The full setup guide has every step, with what to do if something doesn’t arrive.

Also in Agent frameworks & builders

The same live web data, in the other tools of this kind.

Live web data, in Stirrup.

Ask in your own words for companies, places, people, filings or anything else the web lists.

Read the guideTalk to a human