Skip to the page

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 platforms

What 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 to SpecStream, and URL to https://api.specstream.ai/mcp. Use a description the model can choose by, such as Search 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 Bearer followed by one SpecStream key. Everyone spends from that key, up to its spending limit.

    Auth Data
    Type: API Key
    Header: Authorization
    Value: Bearer {{API_KEY}}
  4. 4. Try a tool

    Save the server and open it. Select Try beside search_web, enter a question as q, 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.

ToolWhat it doesCost
search_webSearches the live web with {"q": "<the question>"} and returns up to 10 results, each with its page.$5 per 1,000 searches
read_pagesReturns 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_workDeep 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].