> SpecStream is the live web data engine for teams and agents. This is the Markdown copy of https://specstream.ai/docs/integrations/truefoundry. Every page, with what SpecStream does and costs: https://specstream.ai/llms.txt

# 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](https://specstream.ai/integrations/truefoundry.md)

## 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](https://specstream.ai/signup?utm_source=truefoundry).
-   A SpecStream API key with a spending limit for each person, or one shared key.

1.  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

    ## 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

    ## 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

    ```text
    Type:   API Key
    Header: Authorization
    Value:  Bearer {{API_KEY}}
    ```

4.  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

    ## 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](https://specstream.ai/docs/mcp.md) 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](https://specstream.ai/docs/billing.md) 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 [support@specstream.ai](mailto:support@specstream.ai).

## More

[SpecStream for TrueFoundry](https://specstream.ai/integrations/truefoundry.md) covers what it does in TrueFoundry on one page. Every other tool has its guide in [Connect your tools](https://specstream.ai/docs/integrations.md). You see the most a request can cost before it starts, and the matches are paid from your balance. [Billing](https://specstream.ai/docs/billing.md) has the details. For help, email [support@specstream.ai](mailto:support@specstream.ai).
