Skip to the page

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

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.
  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, 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. 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
    {
    "specstream": {
    "url": "https://api.specstream.ai/mcp",
    "transport": "streamable_http",
    "headers": {
    "Authorization": "Bearer YOUR_SPECSTREAM_API_KEY"
    }
    }
    }
  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. 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. 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
    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.

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. Questions go to [email protected].

More

SpecStream for MaxKB covers what it does in MaxKB 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].