Boomstream API Ecosystem: REST API, API Explorer and MCP Server for Video Content Management

June 25, 2026

In the modern digital world, video content has become the backbone of communication, education, and marketing. The Boomstream platform offers a comprehensive solution for video hosting, conferencing, live streaming, and content monetization. In this article, we take a detailed look at the Boomstream API ecosystem, including the REST API, API Explorer, and the innovative MCP Server, which opens up new possibilities for integration with artificial intelligence.


What is Boomstream?

Boomstream is an online video platform that lets you upload, store, and stream video content, and monetize it by selling access to videos and live streams. The platform supports uploading video in any way: via browser, FTP, TUS, Google Drive, Vimeo, and API. Key capabilities include:

  • Branded video player
  • Comprehensive content protection
  • In-player Pay-Per-View (PPV) payments
  • Viewing statistics
  • Integration with payment systems

For developers, Boomstream provides an API that allows full automation of managing video content, broadcasts, playlists, chats, and other aspects of the platform.


Boomstream REST API: full control over the video platform

Boomstream REST API v1.2 is the primary interface for programmatic interaction with the platform. The API lets you manage video hosting, live streams, PPV content, conferences, folders, playlists, statistics, chats, subtitles, timecodes, webhooks, and much more.

The REST API documentation is available at https://boomstream.com/documentation/api

Key features of the REST API

  • Authentication is performed with an apikey (found in the "Integration" section of your account settings). The key can be passed in two ways:
    • as an apikey parameter — in GET parameters or in the JSON request body;
    • via the Authorization: Bearer <apikey> HTTP header. If the apikey parameter is not provided, the key is taken from this header. An explicitly passed apikey parameter takes precedence over the header.
  • Data transfer formats:
    • Parameters can be passed via either GET or POST;
    • Alternatively — POST with the Content-Type: application/json header and parameters in the JSON body;
    • Response formats: JSON and XML (format=json or format=xml).
  • Versioning: pass ver=1.2 to use the current API version with updated response formats.
  • Response status: every response contains a Status: Success or Failed field. On error, a Message field with a description is added.

Main API sections

The REST API covers all the key platform features:

Section Description
Media Managing recorded videos (VOD): info, creation, upload
Live Managing live streams: creation, control, scheduling
PPV Pay-Per-View subscriptions: creation, list of buyers, access control
Conference Video conferences: creation, management, participants
Playlist Playlists: creation, update, reordering
Stats Viewing statistics by project, target, or session
Chat Chat settings and messages for broadcasts
Screenshot Managing thumbnails and screenshots
Subtitles Managing subtitles: enabling, uploading, setting default
Timecodes Managing chapters and timecodes for video navigation
Webhook Managing webhooks: list, create, update, delete
RecordLive Managing live stream recording
Materials, Folders, Project Managing materials, folders, and project settings

API Explorer: interactive documentation for a quick start

Boomstream API Explorer is an interactive tool that lets developers explore and test API methods directly in the browser, without writing any code.

Benefits of API Explorer

  1. Quick introduction to the API — you can immediately see how various methods work, what parameters they accept, and what data they return.
  2. Testing without code — send real requests to the API and instantly get responses, which significantly speeds up development and debugging.
  3. Clear documentation — all methods are organized into sections, making it easy to navigate and find the functions you need.
  4. Lower entry barrier — even developers unfamiliar with the platform can quickly get up to speed and start integrating.

API Explorer is available at https://api.boomstream.com/ and serves as the starting point for integration with Boomstream.


MCP Server: Boomstream for the age of artificial intelligence

Boomstream MCP Server is an innovative solution implementing the Model Context Protocol (MCP) to integrate the Boomstream API with LLM agents. MCP is an open protocol designed to standardize interaction between AI applications and external tools and data sources.

What is an MCP Server?

An MCP Server is a server that gives AI agents (such as Claude Desktop, claude.ai, the VS Code MCP extension, and other compatible clients) access to tools and data through a standardized protocol. The Boomstream MCP Server turns all Boomstream API features into a set of tools that AI agents can call naturally.

Technical specifications

  • Version: v0.7.1
  • Number of tools: 105 tools covering 28 resource families
  • Transports:
    • stdio — for Claude Desktop (local child process)
    • SSE (Server-Sent Events) — for claude.ai and remote clients, hosted at mcp.boomstream.com
  • Authentication: Authorization: Bearer (HTTP header)

Endpoints

Path Method Authentication Purpose
/ GET none Landing page
/sse GET Bearer SSE event stream + session setup
/messages/?sessionId= POST Bearer JSON-RPC message channel
/health GET none Health check — returns {"status":"ok"}

Limits

  • Per-IP: 120 requests/min, 20 concurrent connections
  • Per-session: 120 requests/min (sustained), 40 burst → HTTP 429 + Retry-After

Session lifecycle

  • Sessions are stored in memory on each pod
  • Cross-pod routing via forwarding
  • Idle timeout: 30 minutes
  • The SSE stream is closed automatically after timeout

Architecture

  • Phase A: shared apikey via Bearer
  • Phase B (planned): per-user OAuth

Quick start with MCP Server

Via Claude Code CLI:

Bash
claude mcp add --transport sse boomstream https://mcp.boomstream.com/sse \
  --header "Authorization: Bearer <your-api-key>"
claude mcp list  # expect: boomstream ✓ Connected

Via Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

JSON
{
  "mcpServers": {
    "boomstream": {
      "transport": "sse",
      "url": "https://mcp.boomstream.com/sse",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Via MCP SDK (Node.js):

JavaScript
import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'

const transport = new SSEClientTransport(
  new URL('https://mcp.boomstream.com/sse'),
  { requestInit: { headers: { Authorization: `Bearer ${apikey}` } } }
)
const client = new Client({ name: 'my-app', version: '0.1' }, { capabilities: {} })
await client.connect(transport)

NPM package: @boomstream/mcp

MCP Server tool catalog

The MCP Server provides 105 tools grouped by section:

Section Tools Description
PPV 13 Pay-Per-View subscriptions
Live 8 Managing live streams
Media 7 Managing VOD content
CameraLive 7 IP cameras
Playlist 7 Playlists
Conference 6 Video conferences
Subtitles 6 Subtitles
Webhook 6 Webhooks
App 5 Project settings
RecordLive 4 Live stream recording
Screenshot 4 Screenshots and thumbnails
Timecodes 4 Timecodes
Stats 3 Statistics
Chat 2 Chat

Example tools:

  • boomstream_media_info
  • boomstream_ppv_list_buyers
  • boomstream_live_create

LLM agents call these tools, and the MCP Server translates them into HTTP requests to https://boomstream.com/api/, parses the responses, and returns structured JSON.

Business benefits of the MCP Server

  1. AI integration without writing code — AI agents can manage video content through natural language.
  2. Reduced complexity and cost — no need to develop your own AI integrations.
  3. Scalability and flexibility — the MCP Server provides standardized interaction.
  4. Access to real-time data — AI agents can query the API directly.
  5. A single point of control — all 105 tools are available through one MCP Server.

Use cases

For developers

  • Integrating Boomstream with existing systems via the REST API
  • Automating video upload and management
  • Building custom solutions for working with content
  • Developing AI agents to manage the video platform via the MCP Server

For business

  • Building educational platforms with video content
  • Hosting online conferences and webinars
  • Monetizing video through PPV and subscriptions
  • Analytics of views and viewer behavior

Conclusion

The Boomstream ecosystem offers developers and businesses a complete set of tools for working with video content:

  • REST API — an interface for programmatic control of all aspects of the platform
  • API Explorer — interactive documentation for quickly learning and testing the API
  • MCP Server — a solution that unlocks integration with AI agents and LLMs

Get started today