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.
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.tomlat the root of your project, or in~/.reasonix/config.toml(%APPDATA%\reasonix\config.tomlon Windows) to have it in every project.type = "http"connects to SpecStream's server over Streamable HTTP.reasonix.toml - 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
/mcppanel does the same: selectspecstreamand pressa.Shell - 3
3. Check the tools and ask
Open
/mcpin a session, or the MCP panel in Studio, and selectspecstreamto see its tools. They reach the model asmcp__specstream__search_web,mcp__specstream__read_pages,mcp__specstream__compileand the rest. Then ask in the task:In a Reasonix session - 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 asSPECSTREAM_API_KEYbefore you start Reasonix.Reasonix expands
${SPECSTREAM_API_KEY}inenvfrom the environment, so the key stays out of the file. Ifspecstream-mcp-stdioisn't on yourPATH, put its full path incommand.reasonix.toml
What Reasonix calls
search_webanswers 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_pagesreads 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.compilereads a request for many records,quote_capacity_workprices it, andauthorize_capacity_workstarts it only after you approve the maximum.get_findfollows the run, andlist_find_rowsreads 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].