> SpecStream is the live web data engine for teams and agents. This is the Markdown copy of https://specstream.ai/docs/integrations/zoo-code. Every page, with what SpecStream does and costs: https://specstream.ai/llms.txt

# 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](https://specstream.ai/integrations/zoo-code.md)

## What you need

-   Zoo Code in VS Code.
-   A SpecStream account. New accounts start with $10 of credit, no card. [Create one](https://specstream.ai/signup?utm_source=zoo-code).

1.  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

    ## 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

    ```json
    {
      "mcpServers": {
        "specstream": {
          "type": "streamable-http",
          "url": "https://api.specstream.ai/mcp",
          "alwaysAllow": [],
          "disabled": false
        }
      }
    }
    ```

3.  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

    ## 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

    ```text
    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](https://specstream.ai/workspace/agents?tab=keys&utm_source=zoo-code), 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](https://specstream.ai/docs/billing.md) has the details, and the [MCP reference](https://specstream.ai/docs/mcp.md) 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 [support@specstream.ai](mailto:support@specstream.ai).

## More

[SpecStream for Zoo Code](https://specstream.ai/integrations/zoo-code.md) covers what it does in Zoo Code on one page. Every other tool has its guide in [Connect your tools](https://specstream.ai/docs/integrations.md). You see the most a request can cost before it starts, and the matches are paid from your balance. [Billing](https://specstream.ai/docs/billing.md) has the details. For help, email [support@specstream.ai](mailto:support@specstream.ai).