AIOZ MCP Server

The AIOZ MCP Server is a Model Context Protocol (MCP) (opens in a new tab) server for connecting MCP-compatible Super Intelligence clients to AIOZ Stream media and live streaming operations.

Use this page to build and run the server locally, review the tools it exposes, and connect clients such as Cursor, Claude CLI, ChatGPT, or VS Code.

When to use this page

Use this page if you want to:

• Count videos and audios in an AIOZ Stream account from a Super Intelligence client.
• List videos or retrieve playback URLs by video name.
• Create a live stream key for broadcasting.
• Configure an MCP client to call AIOZ Stream tools.

Prerequisites

• A valid AIOZ Stream (opens in a new tab) account.
• AIOZ Stream public key and secret key from the API Keys page (opens in a new tab).
• An MCP-compatible client, such as Cursor, Claude CLI, ChatGPT connectors, or VS Code with GitHub Copilot Agent mode.

Connection URL and api_key

Connect MCP clients to:

https://mcp.aiozstream.network/sse?api_key=<BASE64URL_STREAM_CREDENTIALS>

Create <BASE64URL_STREAM_CREDENTIALS> as follows:

1. Open the AIOZ Stream API Keys page (opens in a new tab) and copy your public key and secret key.

2. Create this JSON object with the exact field names shown below:

   { "publicKey": "<PUBLIC_KEY>", "secretKey": "<SECRET_KEY>" }

3. Encode the complete JSON string with base64url, without padding. The encoded result is the api_key value.

For example, with Node.js:

node -e 'const value={publicKey:process.env.AIOZ_STREAM_PUBLIC_KEY,secretKey:process.env.AIOZ_STREAM_SECRET_KEY}; console.log(Buffer.from(JSON.stringify(value)).toString("base64url"))'

Set AIOZ_STREAM_PUBLIC_KEY and AIOZ_STREAM_SECRET_KEY in your local environment before running the command. Never commit either credential or the encoded api_key.

Available MCP tools

The server exposes the following tools to connected MCP clients. All tools use AIOZ Stream credentials from the SSE api_key query parameter. Do not pass publicKey or secretKey as tool arguments.

count-total-media

Returns the total number of videos and audios in an AIOZ Stream account.

This tool has no arguments. It uses credentials from the SSE api_key query parameter.

get-video-urls

Searches for a video by name and returns its playback and asset URLs.

get-list-video

Returns a list of all videos in an AIOZ Stream account.

This tool has no arguments. It uses credentials from the SSE api_key query parameter.

create-livestream-key

Creates a live stream key in an AIOZ Stream account.

get-analytics-data

Retrieves analytics data for an AIOZ Stream account over a date range.

get-aggregated-metrics

Retrieves aggregated view or watch time metrics for video or audio over a date range.

get-breakdown-metrics

Retrieves breakdown metrics for video or audio over a date range by a supported metric type.

get-balance

Retrieves the balance for an AIOZ Stream account.

This tool has no arguments. It uses credentials from the SSE api_key query parameter.

get-data-consumed

Retrieves data consumed by an AIOZ Stream account over a date range.

Configure MCP clients

Choose the client you want to connect. The examples below use the AIOZ Stream MCP endpoint.

Cursor supports MCP through its MCP settings file.

1Open MCP settings

• Press Ctrl + Shift + P on Windows/Linux or Cmd + Shift + P on macOS.
• Type Open MCP Settings and press Enter.
• Cursor opens mcp.json, usually located at ~/.cursor/mcp.json.

2Add the AIOZ MCP Server

Add the aioz-mcp-server entry inside mcpServers:

{
  "mcpServers": {
    "aioz-mcp-server": {
      "url": "https://mcp.aiozstream.network/sse?api_key=<BASE64URL_STREAM_CREDENTIALS>"
    }
  }
}

3Save and test

• Save the file.
• Open Cursor Chat with Ctrl + L.
• Try a prompt such as: "Count the total number of videos in my AIOZ Stream account".

Open MCP Settings in Cursor.

Add the AIOZ MCP Server SSE endpoint.

Verify the MCP tools in Cursor Chat.