Blaxel
Deploy SpecStream on Blaxel as a code mode MCP server built from SpecStream's OpenAPI document. Every agent in your workspace can then search the live web and read pages, and Blaxel injects your key into each call.
SpecStream for Blaxel, API & cloud platformsWhat you need
- A Blaxel workspace and the
blCLI, signed in withbl login. - A SpecStream account. New accounts start with $10 of credit, no card. Create one.
- A SpecStream API key with a spending limit, which step 1 creates.
- 1
1. Create an API key
In your SpecStream workspace, open Agents & API, choose API keys, then Create API key. Turn on Authorize paid work: a key without it can't search or read pages. Set a Total spending limit above $0, because that limit is what caps the spending of everything that uses the key.
Copy the key when it's shown. It isn't shown again.
- 2
2. Write the server definition
Code mode turns an OpenAPI document into an MCP server.
OPENAPI_REFERENCEpoints at SpecStream's document. The document names its key schemeapiKey, sent in theAuthorizationheader, so Blaxel reads the key fromAUTH_APIKEYand sends that value as the header. The value is thereforeBearerfollowed by your key.specstream.yaml - 3
3. Deploy it
Pass the key as a secret with
-s, so it stays out of the file. Then wait for the statusDEPLOYEDand read the server's address:Terminal - 4
4. Give it to an agent
Load the server's tools with the Blaxel adapter for your framework and pass them to the agent. The server has two tools:
searchlooks through SpecStream's OpenAPI document for the endpoint, andexecuteruns afetch()call to it in a Blaxel sandbox, with the key added there.src/agent.ts - 5
5. Ask
Name the endpoints in the agent's instructions, so it searches the document for the right ones first:
GET /v1/web-search?q=<the question>answers withdata.answeranddata.sources, andPOST /v1/extractwith{"urls": [...]}returns the main text of up to 20 pages indata.results.Agent instructions
From any MCP client
The deployed server answers at https://run.blaxel.ai/<workspace>/functions/specstream/mcp and takes your Blaxel API key as Authorization: Bearer. Add that address to Cursor, Claude Code or any client that speaks Streamable HTTP. The SpecStream key stays in Blaxel.
Or connect to SpecStream's own MCP server
An agent you deploy on Blaxel can also call https://api.specstream.ai/mcp directly with an MCP client, with the key in a Blaxel secret: put SPECSTREAM_API_KEY in the .env file you deploy with bl deploy. That server's search_web and read_pages tools need no code from the agent, and it adds Deep Search for structured lists. See the agent guide.
Errors
401: the key is missing or wrong. Send it asAuthorization: Bearer <key>.403: the key has no Authorize paid work, or the call would go over the key's spending limit.402: the balance is empty, or the call would go over the account's monthly spending limit.503withRetry-After: wait that many seconds and send it again.
Cost
A search is $5 per 1,000 searches of up to 10 results, or $1 per 1,000 with speed=fast. A page read is $0.80 per 1,000 pages. They come out of your SpecStream balance up to the key's spending limit, with no quote and no approval. Blaxel bills the server and its sandboxes as usual. Balance, quotes, and billing has the details.
Remove
Delete the specstream MCP server in the Blaxel Console or with the bl CLI. To stop the key working everywhere, revoke it under API keys in Agents & API. Results already delivered stay in your workspace. Questions go to [email protected].
More
SpecStream for Blaxel covers what it does in Blaxel 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].