# Huddle01 Web3 Video MCP

> Huddle01 Web3 Video API connects decentralized video meeting management directly into your AI agent. You can automatically create and manage web3 rooms, track real-time participant counts in live sessions, and pull historical data like full recordings or session metadata—all through natural chat commands.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** web3-video, huddle01, video-api, decentralized-communication, meeting-automation

## Description

Managing complex communication infrastructure used to mean logging into a bunch of different dashboards just to check who was there and what got said. Now you can use your AI agent to handle the whole lifecycle. This MCP lets your client connect to Huddle01's Web3 Video SDK, turning complicated video operations into simple conversation steps. Need to know if a room is active? Ask it. Want to see who joined the last call? Your agent pulls that list for you. If you need to build out DAO tooling or just automate community checks, this MCP makes coordinating decentralized meetings feel like chatting with a teammate. Vinkius hosts this connector, so you connect once and get access to manage your entire video infrastructure from any compatible client.

## Tools

### create_room
Creates a new Huddle01 video room. You must tell the tool if it should be locked or unlocked.

### get_live_session_details
Fetches all details for one specific meeting that is currently running.

### get_live_session_participants
Gets a list of every single person who is actively logged into the room right now.

### get_live_sessions
Pulls a list of all meeting rooms that are currently active and running live.

### get_metrics
Retrieves usage statistics, showing how much API capacity you’ve used so far.

### get_participant_list
Gets a list of people who joined a specific meeting session at any point in the past.

### get_recordings
Fetches video recordings that were created using the SDK, allowing filtering by session ID.

### get_room_details
Retrieves general information about a specific room you're interested in.

### get_room_metadata
Gets only the metadata associated with a particular room, skipping the rest of the data.

### get_room_sessions
Retrieves all past meetings that were ever held within one specific room.

### get_rooms
Fetches a complete list of every room associated with your API key.

## Prompt Examples

**Prompt:** 
```
Create a new locked Huddle01 room for our private team sync.
```

**Response:** 
```
I've created a new locked room for you. The Room ID is 'abc-123-xyz'. You can now share this ID with your team.
```

**Prompt:** 
```
Show me all currently active live sessions and how many people are in them.
```

**Response:** 
```
Fetching live sessions... I found 2 active rooms. Room 'room-A' has 5 participants, and Room 'room-B' has 12 participants.
```

**Prompt:** 
```
List the recordings available for session ID 'sess-9988'.
```

**Response:** 
```
I found one recording for session 'sess-9988'. You can access it at the following URL: [Recording Link].
```

## Capabilities

### Create Meeting Spaces
It sets up brand new Huddle01 meeting rooms, letting you specify if the space should be locked or unlocked.

### Check Live Room Status
You can get a real-time count of active meetings and see exactly who is currently logged into them.

### Review Past Meetings
It pulls up details about rooms that ran previously, including participant lists and general session info.

### Fetch Recordings
You retrieve the actual video recordings from a past session using a specific ID.

### Monitor Usage Stats
It grabs current usage metrics so you know how much API capacity you've used.

## Use Cases

### Post-Event Debriefing
A Community Manager needs to know who attended a recent live call and where the video recordings are. They ask their agent, which runs `get_room_sessions` first, then pulls participant lists with `get_participant_list`, and finally retrieves all relevant files using `get_recordings`. Problem solved.

### Pre-Meeting Setup
A Product Team needs to schedule a private sync. Instead of manually creating the room in a console, they instruct their agent to use `create_room` with specific metadata, getting an immediate, locked Room ID back for sharing.

### System Audit
An Operations Engineer needs to see how many rooms are currently active and if anyone is suspicious. They run `get_live_sessions` and then use `get_live_session_details` on the results to check specific room configurations.

### Platform Health Check
The DevOps team needs a quick snapshot of usage across all environments. They run `get_rooms` to list every configured space and immediately follow up with `get_metrics` to see the API consumption for that month.

## Benefits

- Need to know if a meeting is running? Use `get_live_sessions` to instantly pull all active room IDs without leaving your chat interface. Quick status checks save time.
- Stop digging through dashboards for recordings. Just ask your agent to use `get_recordings` and specify the session ID, and you get direct access to the files.
- Tracking attendance used to be a pain. Now, by running `get_live_session_participants`, you get an immediate count of who's present in any given room.
- Setting up meetings is easy too. The agent handles calling `create_room` and lets you instantly deploy new meeting spaces for your team.
- You always know where you stand. Running `get_metrics` tells you exactly how much API capacity you’ve consumed, so there are no surprise bills later.

## How It Works

The bottom line is, it takes complex video infrastructure tasks and handles them via simple conversation prompts.

1. First, subscribe to this MCP and plug in your Huddle01 API Key from the developer dashboard.
2. Your AI client sends a natural language command (e.g., 'Show me active rooms').
3. The MCP executes the necessary tool call and passes back structured data—like participant lists or recording links—that your agent can use immediately.

## Frequently Asked Questions

**How do I check if a meeting is currently happening using get_live_sessions?**
You run the `get_live_sessions` tool to pull all active rooms. The output gives you a list of running room IDs, letting you know instantly what's live.

**What is the difference between get_participant_list and get_live_session_participants?**
Use `get_live_session_participants` when you need a count of people actively connected right now. Use `get_participant_list` if you just want to know every person who joined that session at some point in the past.

**Can I get recordings from an old room using get_recordings?**
Yes, but you need a specific Session ID. You must pass this ID into `get_recordings` so it knows exactly which video content to fetch for you.

**How do I check if my API usage is spiking using get_metrics?**
Simply call `get_metrics`. This tool grabs your current usage statistics, giving you a clear picture of how much capacity the platform has used up to this point.

**When I use `create_room`, how do I specify if the room should be locked or unlocked?**
You must pass a boolean value specifying the lock status when calling `create_room`. This ensures your new meeting space starts with the exact configuration you need, whether it's for private use or open collaboration.

**What is the key difference between getting room data using `get_room_details` versus `get_room_metadata`?**
`get_room_details` fetches general information about a room, like its creation date. Conversely, `get_room_metadata` returns only the custom metadata you added, letting you inspect highly specific data points without clutter.

**If I want to see every room I've ever set up, should I use `get_rooms`?**
Yes, calling `get_rooms` fetches a list of all rooms associated with your API key. This is useful for auditing or checking which spaces might need configuration updates across the board.

**I want to know the full timeline of meetings in one room; should I use `get_room_sessions`?**
Using `get_room_sessions` is correct. It pulls every session record that has ever taken place within a specific Room ID, giving you the complete historical timeline for that meeting space.

**Can I see who is currently in a live meeting room?**
Yes! Use the `get_live_session_participants` tool with the specific Room ID to fetch a real-time list of all connected peers.

**How do I create a new meeting room with custom settings?**
You can use the `create_room` tool. It allows you to specify if the room should be locked and lets you attach custom JSON metadata for your application's needs.

**Can I check how many total minutes or sessions I have used?**
Absolutely. The `get_metrics` tool retrieves comprehensive usage statistics including total sessions, duration, users, and recording counts associated with your API key.