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

# Crush

Crush's built-in `web_search` tool queries DuckDuckGo. Add SpecStream with one `mcp add` command in your `crushrc`, and Crush can search the live web, read whole pages, and build lists with a source on every value.

[SpecStream for CrushCoding agents](https://specstream.ai/integrations/crush.md)

## What you need

-   Crush v0.100.0 or newer.
-   A SpecStream account. New accounts get $10 of credit, no card.

1.  1

    ## 1. Add SpecStream to your crushrc

    Open `~/.config/crush/crushrc`, or `%USERPROFILE%\.config\crush\crushrc` on Windows, and add these lines. To add SpecStream to one project only, put them in `./crushrc` or `./.crushrc` at the project's root instead.

    `mcp add` adds the server, or updates the one named `specstream` if it exists. `--oauth true` turns on Crush's OAuth 2.1 sign-in, so there is no key to paste.

    crushrc

    ```bash
    mcp add specstream \
      --type http \
      --url "https://api.specstream.ai/mcp" \
      --oauth true
    ```

2.  2

    ## 2. Sign in to SpecStream

    Start Crush. It opens a dialog titled **Authenticate with specstream**. Press enter to open your browser, sign in to SpecStream or create an account, and approve the access Crush asks for.

    Crush shows **Authentication successful!** and keeps the token for the next session.

3.  3

    ## 3. Ask Crush

    Ask for something current and name SpecStream. Crush calls `search_web` for a quick answer and `read_pages` for the full text of the pages it found:

    In Crush

    ```text
    Use SpecStream to find the current stable release of Go and read its release notes.
    ```

4.  4

    ## 4. Or connect with an API key

    Use a key on a machine with no browser. In the workspace, open **Agents & API**, choose **API keys**, then **Create API key**, and set a total limit. Export it as `SPECSTREAM_API_KEY` where Crush starts, and send it as a header in place of `--oauth`.

    Crush drops a header whose value is empty, so an unset variable sends no key at all.

    crushrc with a key

    ```bash
    mcp add specstream \
      --type http \
      --url "https://api.specstream.ai/mcp" \
      --header Authorization "Bearer $SPECSTREAM_API_KEY"
    ```

## What Crush gets

SpecStream's server at `https://api.specstream.ai/mcp` adds these tools to Crush.

-   `search_web` answers a question from the live web, with up to 10 results for $5 per 1,000 searches. A search that returns nothing costs nothing.
-   `read_pages` returns the main text of up to 20 pages or documents (PDF, Word, Excel) in one call, at $0.80 per 1,000 pages. A page that gives no text is not charged.
-   Deep Search builds a list from a request in plain words. `compile` reads the request back, `quote_capacity_work` prices it for free, and `authorize_capacity_work` starts it only after you approve the maximum. `get_find` and `list_find_rows` read the rows, each with its source.

## Crush's own web search and SpecStream

Crush ships a `web_search` tool that queries DuckDuckGo, and no setting points it at another search engine. SpecStream runs beside it as an MCP server, so both stay available. Name SpecStream in your request when you want its results.

SpecStream's Search API scores 97.9 F-score on all 1,000 SimpleQA Verified questions and 64.0 item F1 on all 200 WideSearch tasks. The method is on [benchmarks](https://specstream.ai/benchmarks.md).

## Approvals in Crush

Crush asks before it runs a tool you haven't allowed, for example with `permissions allow` in `crushrc`. Searches and page reads are charged per call with no quote. Deep Search adds its own gate: nothing paid starts until you approve the price SpecStream quotes.

## Cost

Connecting SpecStream to Crush is free, and new accounts start with $10 of credit. A search of up to 10 results costs $5 per 1,000, and a page read costs $0.80 per 1,000. Deep Search is priced per delivered row and quoted before it runs, and a run can't cost more than the maximum you approved. See [pricing](https://specstream.ai/pricing.md) and [how billing works](https://specstream.ai/docs/billing.md).

## Remove

Delete the `mcp add specstream` lines from `crushrc` and restart Crush. To end its access, open **Agents & API** in your SpecStream workspace and revoke Crush under **OAuth applications**, or revoke the key under **API keys**. Questions: [support@specstream.ai](mailto:support@specstream.ai).

## More

[SpecStream for Crush](https://specstream.ai/integrations/crush.md) covers what it does in Crush 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).