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

# Grok Build

Add SpecStream to Grok Build with one `grok mcp add` command. Ask in plain words for a list from the live web, see the price before anything runs, and get rows with a source on every value.

[SpecStream for Grok BuildCoding agents](https://specstream.ai/integrations/grok-build.md)

## What you need

-   Grok Build, the `grok` command line from xAI.
-   A SpecStream account. New accounts get $10 of credit, no card.

1.  1

    ## 1. Add SpecStream

    Run this in your terminal. It writes the server to `~/.grok/config.toml`. Add `--scope project` to write it to `.grok/config.toml` in the current directory instead, where your team can commit it.

    Terminal

    ```bash
    grok mcp add --transport http specstream https://api.specstream.ai/mcp
    ```

2.  2

    ## 2. Sign in to SpecStream

    Start `grok` and run `/mcps`. Select **specstream** and press `i`. Grok opens SpecStream's sign-in in your browser. Sign in or create an account, and approve the access Grok asks for. Grok stores the token for later sessions.

    To check the server, run `grok mcp doctor specstream`.

3.  3

    ## 3. Ask Grok

    Describe the list you need and the facts to bring back on each row:

    In Grok Build

    ```text
    Use SpecStream to find open-source Rust crates that parse PDF files, with each one's license, latest release date, and repository.
    ```

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` and add a header to the server's entry. Grok stores header values as written, so reference the key as `${SPECSTREAM_API_KEY}` and never paste it into a project file you commit.

    ~/.grok/config.toml

    ```toml
    [mcp_servers.specstream]
    url = "https://api.specstream.ai/mcp"
    headers = { "Authorization" = "Bearer ${SPECSTREAM_API_KEY}" }
    ```

## How a Deep Search request runs

Grok names each tool with the server first, such as `specstream__compile`, and the model reaches them through its `search_tool` and `use_tool` tools. A request moves through them in order.

-   `compile` reads the request and says back what SpecStream will look for.
-   `quote_capacity_work` prices the request. It spends nothing, and the quote lasts 30 minutes.
-   `authorize_capacity_work` starts the work only after you approve the maximum.
-   `get_find` follows the progress, and `list_find_rows` reads the rows as they arrive, each with its source.

## Search and page reading too

The same server gives Grok `search_web`, which answers a question from the live web with up to 10 results for $5 per 1,000 searches, and `read_pages`, which returns the main text of up to 20 pages or documents for $0.80 per 1,000 pages. Neither needs a quote.

## After the run

`export_find` makes a download link as CSV, Excel, JSON, or HTML. `send_to_destination` sends selected rows to a tool you've connected under **Connections**. Stopping a run keeps what it found so far. For results that should stay up to date, ask Grok to create a monitor, and read more about [schedules](https://specstream.ai/docs/schedules.md).

## Cost

Connecting SpecStream to Grok Build is free, and new accounts start with $10 of credit. Reading a request back and pricing it cost nothing. Deep Search charges for each delivered row, never more than the maximum you approved, and a run that finds nothing costs nothing. See [pricing](https://specstream.ai/pricing.md) and [how billing works](https://specstream.ai/docs/billing.md).

## Disconnect

Run `grok mcp remove specstream`, or turn the server off with `grok mcp disable specstream`. To end its access, open **Agents & API** in your SpecStream workspace and revoke Grok under **OAuth applications**, or revoke the key under **API keys**. Your saved results stay in your workspace. Questions: [support@specstream.ai](mailto:support@specstream.ai).

## More

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