Skip to the page

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

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. 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
    [[plugins]]
    name = "specstream"
    type = "http"
    url = "https://api.specstream.ai/mcp"
  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
    reasonix mcp auth specstream
  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
    Find the latest stable release of PostgreSQL, read its release notes, and update the image tag in docker-compose.yml.
  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
    [[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).
  • 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.

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

More

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