Skip to the page

Zoo Code

Add SpecStream to Zoo Code as a remote MCP server. Then Zoo can search the live web, read pages and ask for structured records in the middle of a task. You see the price before any paid run starts.

SpecStream for Zoo CodeCoding agents

What you need

  • Zoo Code in VS Code.
  • A SpecStream account. New accounts start with $10 of credit, no card. Create one.
  1. 1. Open the MCP settings

    In the Zoo Code pane, select Settings (the gear in the pane's title bar) and open the MCP Servers tab. Check that Enable MCP Servers is on. It is on by default.

  2. 2. Add SpecStream to mcp_settings.json

    Select Edit Global MCP. Zoo Code opens mcp_settings.json. Add the specstream entry below inside mcpServers and save the file.

    Zoo Code needs an explicit type for any server with a url, and it refuses the entry without one. SpecStream uses Streamable HTTP, so the type is streamable-http.

    mcp_settings.json
    {
    "mcpServers": {
    "specstream": {
    "type": "streamable-http",
    "url": "https://api.specstream.ai/mcp",
    "alwaysAllow": [],
    "disabled": false
    }
    }
    }
  3. 3. Sign in to SpecStream

    When the file is saved, Zoo Code connects and finds that SpecStream needs a sign in. A notification says the specstream server requires authentication. Select Authenticate. Your browser opens SpecStream's sign in, where you sign in or create an account and approve the access.

    Zoo Code registers itself with SpecStream, so there is no client ID to enter. The browser tab then says the server authenticated successfully, and you can close it. Requests run on the account that signed in, with its balance and spending limits.

  4. 4. Ask in a task

    Describe what you need from the web and the details to bring back. Zoo asks before each SpecStream tool call unless you allowed that tool. For example:

    In a Zoo Code task
    Search the web for the current LTS version of Node.js and its end-of-life date, read the release page, and update the engines field in package.json.

What Zoo can call

Each tool has its own price.

  • search_web answers a question from the live web, at $5 per 1,000 searches of up to 10 results.
  • read_pages returns the text of the pages you name, at $0.80 per 1,000 pages. A page with no text is not charged.
  • compile reads a request for records and says what SpecStream will look for. quote_capacity_work prices it and spends nothing.
  • authorize_capacity_work starts the run after you approve the maximum. get_find follows progress, and list_find_rows reads the rows, each with its source URL and read time.

Approvals

Leave alwaysAllow empty and Zoo asks before every SpecStream call. To skip the prompt for the calls that cost nothing, open the server's Tools tab in MCP Servers and tick Always allow on compile and quote_capacity_work. Keep authorize_capacity_work for your own click: it is the call that starts paid work. SpecStream adds its own gate, since nothing paid begins until you approve the price it quotes.

Share it with a project

For one repository, select Edit Project MCP instead. Zoo Code creates .roo/mcp.json in the project root, and the same entry works there. If a server name is in both files, the project file wins.

Zoo Code keeps the .roo/mcp.json name, so a project set up for Roo Code loads in Zoo Code as it is. A committed file should hold no key: use the sign in above, or the environment variable below.

Or connect with an API key

Use a key on a machine with no browser, or to give Zoo a spending limit of its own. In SpecStream, open Agents & API, choose API keys, then Create API key, and set a total spending limit.

Set SPECSTREAM_API_KEY in the environment VS Code starts from, and add a header to the entry. Zoo Code replaces ${env:SPECSTREAM_API_KEY} with the value when it connects, so the key stays out of the file:

Cost

Connecting SpecStream to Zoo Code is free. Searches and page reads come out of your balance at the prices above. For records, reading a request and pricing it cost nothing. Each matching row costs 5¢, 15¢ or $1, depending on how much the row needs, plus 5¢ for a person's email and 15¢ for a phone. A run can't cost more than the maximum you approved, and a run that finds nothing costs nothing. Balance, quotes, and billing has the details, and the MCP reference lists every tool.

Disconnect

Delete the specstream entry from mcp_settings.json, or use the delete button on the server in MCP Servers. To end its access on the SpecStream side, open Agents & API in your workspace, choose OAuth applications, and revoke Zoo Code, or revoke the key under API keys. Your saved results stay in your workspace. Questions go to [email protected].

More

SpecStream for Zoo Code covers what it does in Zoo Code on one page. Every other tool has its guide in Connect your tools. You see the most a request can cost before it starts, and the matches are paid from your balance. Billing has the details. For help, email [email protected].