Skip to the page
Get started free

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

What you need

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

  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
    grok mcp add --transport http specstream https://api.specstream.ai/mcp

  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. Ask Grok

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

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

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

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 and how billing works.

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: [email protected].

More

SpecStream for Grok Build covers what it does in Grok Build 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].