Speaking Bots MCP Server

Created By

Meeting-Baas6 months ago

An MCP server that can send speaking bots inside meetings

Content

Speaking Bots MCP Server

Deploy AI-powered speaking agents in video meetings using the MeetingBaas API. This open-source MCP server demonstrates how to connect LLM-powered voice bots to Google Meet, Zoom, and Microsoft Teams, with customizable personas and real-time audio streaming.

Introduction

This project provides a minimal, production-ready API for deploying speaking bots in video meetings. It integrates with MeetingBaas and Pipecat's Python framework for building voice and multimodal conversational agents.

Join meetings as an AI speaking bot
Customizable personas and voices
Real-time bidirectional audio streaming
Minimalist, extensible API design

The API is open source and designed for easy customization and extension.

Getting Started

Clone this repository
Install dependencies
Set your environment variables (see below)
Run locally or deploy to your preferred platform (Docker, fly.io, Vercel, etc.)

Environment Variables

BAAS_API_KEY: Your MeetingBaas API key (required)
BAAS_URL: The MeetingBaas API base URL (required)
NODE_ENV, LOG_LEVEL: (optional)

API Reference

The Speaking Bot API is accessible at https://speaking.meetingbaas.com.

OpenAPI spec: /openapi.json

Example: Join a Meeting as a Speaking Bot

curl -X POST https://speaking.meetingbaas.com/bots \
  -H "Content-Type: application/json" \
  -H "x-meeting-baas-api-key: your-api-key" \
  -d '{
    "meeting_url": "https://us06web.zoom.us/j/123456789?pwd=example",
    "personas": ["baas_onboarder"]
  }'

Key Endpoints

POST /bots — Join a meeting as a speaking bot
DELETE /bots/{bot_id} — Remove a speaking bot from a meeting
POST /personas/generate-image — Generate a persona image

See the OpenAPI spec for full details and parameters.

Command Line Usage

You can interact with the API using curl or any HTTP client. See the example above for joining a meeting. For advanced usage, see the scripts directory (if present) or build your own CLI tools.

Personas System

Speaking bots can be assigned unique personas, each with their own context, voice, and characteristics. Personas are defined in Markdown or JSON and can be extended or customized.

Choose from a library of built-in personas (e.g., baas_onboarder, pirate_queen, quantum_physicist)
Generate custom persona images via the API
Control voice, language, and context for each bot

Directory Structure

api/                # API route handlers and tool registration
config/             # Core configuration and persona management
scripts/            # Command-line tools and utilities