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

# AionUi

Add SpecStream to AionUi as a remote MCP server. Then the agents you run in AionUi can search the live web, read pages and ask for structured records. You see the price before any paid run starts.

[SpecStream for AionUiAI assistants](https://specstream.ai/integrations/aionui.md)

## What you need

-   A SpecStream account. New accounts start with $10 of credit, no card.
-   AionUi on your computer.

1.  1

    ## 1. Create a SpecStream API key

    Open **Agents & API** in the SpecStream workspace, go to **API keys**, and select **Create API key**. Give the key the spending limit your agents should have, and no more.

2.  2

    ## 2. Open AionUi's MCP settings

    In AionUi, open **Settings** from the left sidebar and choose **Tools**. MCP servers are listed under **MCP Tools Configuration**. Select **Add MCP**, then **Import from JSON**.

3.  3

    ## 3. Paste the SpecStream entry

    AionUi's import takes a JSON object with a `mcpServers` field at the top, and a remote server needs a `url`. Paste this entry, put your key where it says `YOUR_SPECSTREAM_API_KEY`, and confirm. The server is `https://api.specstream.ai/mcp`, over Streamable HTTP.

    Import from JSON

    ```json
    {
      "mcpServers": {
        "specstream": {
          "type": "http",
          "url": "https://api.specstream.ai/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_SPECSTREAM_API_KEY"
          },
          "description": "Live web search, page reading and structured records"
        }
      }
    }
    ```

4.  4

    ## 4. Check the connection

    AionUi tests a server as soon as you add it. When the connection works, SpecStream shows **Available**. To test again later, use **Check MCP Availability** on the server's row.

5.  5

    ## 5. Ask in a conversation

    Start a conversation with an agent that has SpecStream turned on. Ask for what you need and the details to bring back. For example:

    In an AionUi conversation

    ```text
    Find open-source MCP servers for PostgreSQL released this year, with each one's repository, license and the date of its latest release.
    ```

## Why the type is http

AionUi decides the transport from the entry. If `type` is `sse`, or the address contains `/sse`, it treats the server as SSE. Any other remote entry is `http`. SpecStream's address ends in `/mcp` and uses Streamable HTTP, so `http` is the right type.

## Sign in instead of pasting a key

You can leave out `headers`. AionUi then checks whether the server needs a sign in. If SpecStream shows **Login required**, select **Login** and sign in to SpecStream in the browser window that opens. Requests run on your account, and AionUi stores no key.

## Your agents share the server

AionUi manages MCP servers in one place. It passes them to the agents it runs, such as Claude Code, Codex and Gemini CLI, for each transport that agent supports. Add SpecStream once and every supported agent can use it.

## What the agents call

Each tool has its own price.

-   `search_web` answers a question from the live web, at $5 per 1,000 searches of up to 10 results.
-   `read_pages` returns the text of the pages you name, at $0.80 per 1,000 pages. A page with no text is not charged.
-   `compile` reads a request for records and says what SpecStream will look for. `quote_capacity_work` prices it and spends nothing.
-   `authorize_capacity_work` starts the run after you approve the maximum. `get_find` follows progress, and `list_find_rows` reads the rows, each with its source.

## Limits and cost

Reading a request back and pricing it cost nothing. A run for records charges only for the matches delivered and never goes past the maximum you approved. Searches and page reads come out of your balance, up to the spending limit on the key. See [how quotes and billing work](https://specstream.ai/docs/billing.md) and the [MCP reference](https://specstream.ai/docs/mcp.md).

## Remove SpecStream

Delete the server in **MCP Tools Configuration** and confirm. Agents that keep their own MCP settings may hold a copy, so remove it there as well. Revoke the key in **Agents & API**. Results you saved stay in your workspace. Questions: [support@specstream.ai](mailto:support@specstream.ai).

## More

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