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

# MaxKB

Add SpecStream to MaxKB as an MCP tool, and your agents can search the live web, read pages and ask for structured rows, with the price shown before any paid work runs. MaxKB takes the server as one JSON block on its MCP page.

[SpecStream for MaxKBAgent frameworks & builders](https://specstream.ai/integrations/maxkb.md)

## What you need

-   MaxKB v2, signed in as a user who can create tools. MaxKB's MCP tools connect to SSE or Streamable HTTP servers, and SpecStream is Streamable HTTP.
-   A SpecStream account. New accounts get $10 of credit, no card. [Create one](https://specstream.ai/signup?utm_source=maxkb).

1.  1

    ## 1. Create an API key

    MaxKB sends a fixed header to an MCP server, so SpecStream connects with an API key. In SpecStream, open [Agents & API](https://specstream.ai/workspace/agents?tab=keys&utm_source=maxkb), choose **API keys**, then **Create API key**, and set a spending limit above 0. Copy the key from the next screen. SpecStream shows it once.

2.  2

    ## 2. Create the MCP tool

    In MaxKB, open **Tool**, click **Create** and choose **MCP**. Enter `SpecStream` as the **Name**. Under **MCP Server Config**, paste this block, with your key in place of `YOUR_SPECSTREAM_API_KEY`:

    MCP Server Config

    ```json
    {
      "specstream": {
        "url": "https://api.specstream.ai/mcp",
        "transport": "streamable_http",
        "headers": {
          "Authorization": "Bearer YOUR_SPECSTREAM_API_KEY"
        }
      }
    }
    ```

3.  3

    ## 3. Test and create

    Click **Test Connection**. MaxKB lists the SpecStream tools when the key and address are right. Then click **Create**.

    MaxKB accepts only `sse` and `streamable_http` as `transport`, written with an underscore. The placeholder in the form shows `sse`; SpecStream needs `streamable_http`.

4.  4

    ## 4. Turn the tool on

    A new MCP tool starts as **Disabled**. On the **Tool** page, hover over the SpecStream card and turn on its switch. The card then reads **Enabled**. An agent can pick only enabled tools.

5.  5

    ## 5. Add it to an agent

    Open the agent's settings. Next to **MCP**, click the add icon. In the **Settings** dialog, keep **Reference MCP**, pick SpecStream under **MCP Tool**, and click **Save**. Then click **Publish**.

    Ask the agent something that needs the web:

    In a MaxKB chat

    ```text
    Search the web for the latest PostgreSQL release and read its release notes page.
    ```

## What the agent can call

SpecStream's MCP server gives the agent three kinds of work. Each runs on the account that owns the key, within its spending limit.

-   `search_web` answers a question from the live web, at $5 per 1,000 searches of up to 10 results, with no quote and no approval.
-   `read_pages` returns the text of the pages you name, at $0.80 per 1,000 pages. A page that gives no text is not charged.
-   `compile`, `quote_capacity_work`, `authorize_capacity_work`, `get_find` and `list_find_rows` turn a request in plain words into structured rows. The quote names the most the run can cost, and paid work starts only when `authorize_capacity_work` is sent with the maximum you approved. Rates are on the [pricing page](https://specstream.ai/pricing.md).

## Use it in a workflow

In a workflow agent, add the **MCP Call** node. Choose **Reference MCP** and pick SpecStream, or choose **Custom** and paste the same block into **MCP Server Config**. Then select the tool the node calls.

## Paste it into one agent only

To skip the shared tool, open the **Settings** dialog next to **MCP** in the agent, choose **Custom**, and paste the block from step 2 into **MCP Server Config**. The server then belongs to that agent alone.

## If the test fails

-   `transport` must read `streamable_http`. MaxKB refuses any other value with "Only support transport=sse or transport=streamable\_http".
-   The `url` must end in `/mcp`.
-   The header must read `Bearer` followed by the key, with one space.
-   A key with no spending permission or a limit of 0 can connect and read, but cannot search or read pages. Create a key with a spending limit above 0.

## Keep the key safe

The key sits in the tool's **MCP Server Config**, so anyone who can edit the tool can read it. Give the key a spending limit that fits the agent, and share the tool only with the workspaces that need it.

## Remove

Turn off the tool's switch on the **Tool** page, or delete the tool. To stop the key everywhere, revoke it in **Agents & API**. Other clients are in [MCP](https://specstream.ai/docs/mcp.md). Questions go to [support@specstream.ai](mailto:support@specstream.ai).

## More

[SpecStream for MaxKB](https://specstream.ai/integrations/maxkb.md) covers what it does in MaxKB 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).