eve
Add SpecStream to an eve agent as an MCP connection. The agent searches the live web, reads pages and asks for structured lists through SpecStream's MCP server, and the key stays in your environment, out of the conversation.
SpecStream for eve, Agent frameworks & buildersWhat you need
- An eve project (
npx eve@latest init my-agent) on Node.js 24 or later. - 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. Add the key to the environment
Add the key to the Vercel project that hosts the agent, then pull it into your local environment. Locally, a line
SPECSTREAM_API_KEY=...in.env.localworks too.Terminal - 3
3. Add the connection
Create one file under
agent/connections/. The file name is the connection name, so this one registers asspecstream.auth.getTokensends the key asAuthorization: Bearer, and eve calls it on each connection, so the key is read from the environment and never enters the model's context.tools.allowkeeps the agent to search and page reading:agent/connections/specstream.ts - 4
4. Ask
Run
npx eve devand ask about something recent. The model finds the tools witheve__searchand calls them asspecstream__search_webandspecstream__read_pages. Check that the turn shows a SpecStream tool call.In the terminal UI
What each tool does
The SpecStream server gives the agent three kinds of work. Add a tool's name to tools.allow to give it to the agent.
| Tool | What it does | Cost |
|---|---|---|
search_web | Searches the live web with {"q": "<the question>"} and returns up to 10 results, each with its page. | $5 per 1,000 searches |
read_pages | Returns the main text of 1 to 20 pages or documents (PDF, Word, Excel), read live, or from SpecStream's own dated copy when a page is slow or refuses, with {"urls": [...]}. | $0.80 per 1,000 pages |
compile, quote_capacity_work, authorize_capacity_work | Deep Search: reads a request in plain words, prices it, and starts it after a maximum is approved. Rows come back with list_find_rows. | 5¢, 15¢ or $1 a delivered row, plus 5¢ for a person's email and 15¢ for a phone |
Deep Search with a person's approval
To let the agent ask for structured lists, allow compile, quote_capacity_work, authorize_capacity_work, get_find and list_find_rows. authorize_capacity_work starts paid work with the approved maximum, so make the turn wait for a person before it runs:
Deploy
Run eve deploy, or push to the Git-connected Vercel project. The deployed agent reads SPECSTREAM_API_KEY from the project's environment, so keep the variable in every environment that runs the agent.
Cost
A search is $5 per 1,000 searches of up to 10 results, and a page read is $0.80 per 1,000 pages. Neither needs a quote or an approval, so they come out of your balance up to the key's spending limit. Deep Search rows cost 5¢, 15¢ or $1, and a run can't cost more than the maximum approved. Balance, quotes, and billing has the details.
Remove
Delete agent/connections/specstream.ts and remove SPECSTREAM_API_KEY from the Vercel project. 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 eve covers what it does in eve 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].