TrueFoundry
Register SpecStream on the TrueFoundry MCP gateway as a remote MCP server. The people and teams you add reach SpecStream's live web search, page reading and Deep Search through the gateway, from the Playground or from their own clients.
SpecStream for TrueFoundry, API & cloud platformsWhat you need
- A TrueFoundry AI Gateway where you can add MCP servers.
- A SpecStream account. New accounts start with $10 of credit, no card. Create one.
- A SpecStream API key with a spending limit for each person, or one shared key.
- 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 SpecStream as a remote MCP server
In TrueFoundry, open MCP Gateway in the left sidebar and click Add Server. Select Connect any Remote MCP Server.
Set Name to
specstream, Display Name toSpecStream, and URL tohttps://api.specstream.ai/mcp. Use a description the model can choose by, such asSearch the live web, read pages, and build priced lists with a source on every value.Under Collaborators, add the users and teams that may use it. - 3
3. Set the key
Under Auth Data, choose API Key and set the header name to
Authorization. Then pick one of two modes:Individual Credentials: set the value to
Bearer {{API_KEY}}. Each person adds their own SpecStream key on the server's Auth Overrides tab, so each one spends from their own balance and limits.Shared Credentials: set the value to
Bearerfollowed by one SpecStream key. Everyone spends from that key, up to its spending limit.Auth Data - 4
4. Try a tool
Save the server and open it. Select Try beside
search_web, enter a question asq, and select Execute Tool. The reply lists each page with its title, link and snippet. In the Playground, select the server and its tools and send a prompt to see which tools the model calls. - 5
5. Connect a client
Open the server's How To Use tab and pick your client. TrueFoundry writes the configuration for Cursor, Claude Code, VS Code and others and points it at the gateway, so your clients never hold the SpecStream key.
What each tool does
Turn individual tools on or off on the server page to expose only the ones your team needs, for example only search_web and read_pages.
| 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 through the gateway
compile reads a request and returns the conditions and fields to bring back. quote_capacity_work prices it, and the quote lasts 30 minutes. authorize_capacity_work starts the work only with the approved maximum in confirm_max_cents. To keep paid runs out of the gateway, turn authorize_capacity_work off. The agent guide covers every tool.
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, from the balance of the key that made the call, up to its 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 the specstream server from MCP Gateway, or take people off its Collaborators. 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 TrueFoundry covers what it does in TrueFoundry 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].