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

# Reasonix

Reasonix takes MCP servers as `[[plugins]]` entries in `reasonix.toml`. Add SpecStream as one entry, and the coding agent searches the live web, reads pages and asks for structured data from inside your project.

[SpecStream for ReasonixCoding agents](https://specstream.ai/integrations/reasonix.md)

## What you need

-   Reasonix 2.x, as the CLI or Reasonix Studio. These steps follow v2.61.0, the final release.
-   A SpecStream account. New accounts get $10 of credit, no card.
-   For the stdio entry: Python 3.12 or later.

1.  1

    ## 1. Add the server

    Put this entry in `reasonix.toml` at the root of your project, or in `~/.reasonix/config.toml` (`%APPDATA%\reasonix\config.toml` on Windows) to have it in every project. `type = "http"` connects to SpecStream's server over Streamable HTTP.

    reasonix.toml

    ```toml
    [[plugins]]
    name = "specstream"
    type = "http"
    url  = "https://api.specstream.ai/mcp"
    ```

2.  2

    ## 2. Sign in to SpecStream

    Run the command below. Reasonix names the sign-in host and asks before a browser opens. Sign in to SpecStream and approve the access Reasonix asks for. SpecStream uses OAuth for this, so there is no key in the file, and Reasonix refreshes the token on its own.

    In the terminal, the `/mcp` panel does the same: select `specstream` and press `a`.

    Shell

    ```bash
    reasonix mcp auth specstream
    ```

3.  3

    ## 3. Check the tools and ask

    Open `/mcp` in a session, or the MCP panel in Studio, and select `specstream` to see its tools. They reach the model as `mcp__specstream__search_web`, `mcp__specstream__read_pages`, `mcp__specstream__compile` and the rest. Then ask in the task:

    In a Reasonix session

    ```text
    Find the latest stable release of PostgreSQL, read its release notes, and update the image tag in docker-compose.yml.
    ```

4.  4

    ## 4. Or run SpecStream as a stdio plugin

    Use this on a machine with no browser, or where only local servers may run. Install the bridge with `pip install -U specstream-mcp-stdio`. Create an API key under **Agents & API** in your SpecStream workspace, give it a spending limit, and export it as `SPECSTREAM_API_KEY` before you start Reasonix.

    Reasonix expands `${SPECSTREAM_API_KEY}` in `env` from the environment, so the key stays out of the file. If `specstream-mcp-stdio` isn't on your `PATH`, put its full path in `command`.

    reasonix.toml

    ```toml
    [[plugins]]
    name    = "specstream"
    command = "specstream-mcp-stdio"
    args    = []
    env     = { SPECSTREAM_API_KEY = "${SPECSTREAM_API_KEY}", SPECSTREAM_MCP_URL = "https://api.specstream.ai/mcp" }
    ```

## What Reasonix calls

-   `search_web` answers a question from the live web in a few seconds, at $5 per 1,000 searches of up to 10 results. It is the most accurate web search API in the world on the official boards ([benchmarks](https://specstream.ai/benchmarks.md)).
-   `read_pages` reads 1 to 20 URLs (web pages, PDF, Word and Excel) and returns each page's main text, at $0.80 per 1,000 pages. A page with no text is free.
-   `compile` reads a request for many records, `quote_capacity_work` prices it, and `authorize_capacity_work` starts it only after you approve the maximum.
-   `get_find` follows the run, and `list_find_rows` reads the rows, each value with its source URL and read time.

## A key in a header instead of OAuth

On the `http` entry, add `headers = { Authorization = "Bearer ${SPECSTREAM_API_KEY}" }` and export the key. A static `Authorization` header always wins over a saved sign-in, so remove it again if you switch back to OAuth.

## Project file or user file

A project's declarations override a same-name entry in your user file, and inside a project `reasonix.toml` overrides `.mcp.json`. Reasonix also reads a project `.mcp.json` in Claude Code's `mcpServers` shape, so a SpecStream entry written for Claude Code works in Reasonix unchanged. A project `reasonix.toml` is shared with everyone who clones the repository: keep keys in the environment, never in the file.

## Approvals

Reasonix treats installing a server as the approval, so SpecStream's tools run without a second prompt. Searches and page reads take their price from your balance at once. Paid Deep Search work has its own gate: nothing starts until you approve the price SpecStream quotes, and a key's spending limit caps what it can start.

## Cost

Reading a request, pricing it and reading saved results cost nothing. Searches are $5 per 1,000 and page reads $0.80 per 1,000, from your balance. Deep Search bills only the matching rows delivered, never more than the maximum you approved. See [how quotes and billing work](https://specstream.ai/docs/billing.md).

## Disconnect

Remove the entry, or press `d` on it in the `/mcp` panel. Removing the server also clears its saved sign-in. Revoke Reasonix's access in SpecStream's Settings, and revoke a key you made for it under **Agents & API**. Questions: [support@specstream.ai](mailto:support@specstream.ai).

## More

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