Digital Samba Embedded API MCP Server

Interact with the Digital Samba Embedded API for video conferencing features like room management, analytics, recording, and live session control.

GitHub

Digital Samba Embedded API MCP Server

Control your Digital Samba video platform with AI assistants

Server Status MCP Protocol License: MIT

Quick Start • Features • Setup Guides • Tools Reference

Overview

The Digital Samba Embedded MCP Server lets you manage your video conferencing platform using natural language through AI assistants like Claude and ChatGPT. Create rooms, manage recordings, view analytics, and control live sessions—just by asking.

Server URL: https://mcp.digitalsamba.com

What You Can Do

"Create a meeting room for our team standup"
"Show me analytics for yesterday's meetings"
"List all recordings from last week"
"Generate a join link for [email protected]"
"Create a poll asking about meeting preferences"
"Export the chat transcript from today's session"

Quick Start

1. Have a Digital Samba Account

Sign up at Digital Samba if you don't have an account. You'll need Admin access to your team.

2. Connect Your AI Assistant

Add our MCP server to your AI assistant:

AssistantServer URL
Claude Desktophttps://mcp.digitalsamba.com
ChatGPThttps://mcp.digitalsamba.com
Other MCP Clientshttps://mcp.digitalsamba.com

3. Authenticate

When you first connect, you'll be redirected to Digital Samba to log in. Once authenticated, you can start using natural language to manage your account.

Setup Guides

Claude Code

claude mcp add --transport http digitalsamba https://mcp.digitalsamba.com/mcp

Then use the /mcp command in Claude Code to authenticate.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "digitalsamba": {
      "url": "https://mcp.digitalsamba.com/mcp"
    }
  }
}

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop and authenticate when prompted.

Other MCP Clients

Use the server URL https://mcp.digitalsamba.com/mcp with any MCP-compatible client.

Features

Room Management

  • Create, update, and delete rooms
  • Generate secure access tokens for participants
  • Manage default room settings
  • Configure room features (chat, Q&A, recordings, etc.)

Analytics & Reporting

  • Team-wide usage statistics
  • Room and session analytics
  • Participant tracking and engagement metrics
  • Custom date range reporting

Recording Management

  • List and search recordings
  • Archive and unarchive recordings
  • Get download links
  • Bulk recording operations
  • Recording bookmarks

Live Session Control

  • Monitor active rooms and participants
  • Start/stop recordings on demand
  • Start/stop live transcription
  • End sessions remotely
  • Raise/lower participant hands
  • Phone participant integration

Communication Tools

  • Create and manage polls
  • Export chat history, Q&A, and transcripts
  • Delete session data (GDPR compliance)
  • AI-generated session summaries

Content Library

  • Create and organize libraries
  • Upload files and documents
  • Manage folders and hierarchy
  • Create webapps and whiteboards
  • Bulk file operations

Webhooks & Integrations

  • Subscribe to platform events
  • Configure webhook endpoints
  • Manage webhook lifecycle

Role & Permission Management

  • Create custom roles
  • Assign granular permissions
  • Manage team access levels

Available Tools

The MCP server provides 113 tools covering the complete Digital Samba API.

Room Management (11 tools)

ToolDescription
create-roomCreate a new room
update-roomUpdate room settings
delete-roomDelete a room
generate-tokenGenerate participant access token
get-default-room-settingsGet default settings
update-default-room-settingsUpdate default settings
list-roomsList all rooms
get-room-detailsGet room details
list-live-roomsList rooms with active sessions
list-live-participantsList all live participants
get-room-live-infoGet live session info for a room

Session Management (12 tools)

ToolDescription
list-sessionsList all sessions
get-session-summaryGet session details
list-session-participantsList session participants
get-session-statistics-detailsDetailed session stats
list-room-sessionsSessions for a specific room
end-sessionEnd a live session
delete-session-recordingsDelete session recordings
delete-session-resourcesDelete session resources
hard-delete-session-resourcesPermanently delete data
bulk-delete-session-dataBulk delete operations
list-room-transcriptsList room transcripts
list-session-transcriptsList session transcripts

Recording Management (10 tools)

ToolDescription
get-recordingsList recordings with filters
get-recordingGet recording details
delete-recordingDelete a recording
get-recording-download-linkGet download URL
archive-recordingArchive a recording
unarchive-recordingRestore archived recording
get-archived-recordingsList archived recordings
get-room-recordingsRecordings for a room
get-recording-bookmarksGet recording bookmarks
bulk-delete-recordingsDelete multiple recordings

Live Session Controls (8 tools)

ToolDescription
start-recordingStart recording a session
stop-recordingStop recording
start-transcriptionStart live transcription
stop-transcriptionStop transcription
raise-participant-handRaise a participant's hand
lower-participant-handLower a participant's hand
raise-phone-participant-handRaise phone participant hand
lower-phone-participant-handLower phone participant hand

Analytics Tools (8 tools)

ToolDescription
get-team-statisticsTeam-wide metrics
get-room-analyticsRoom usage analytics
get-usage-statisticsOverall usage stats
get-participant-statisticsParticipant analytics
get-session-analyticsSession analytics
get-live-analyticsLive session metrics
get-live-room-analyticsLive metrics for a room
get-participant-analyticsSpecific participant stats

Communication Management (13 tools)

ToolDescription
delete-session-chatsDelete session chat
delete-room-chatsDelete all room chats
delete-session-qaDelete session Q&A
delete-room-qaDelete all room Q&A
delete-session-transcriptsDelete session transcripts
delete-room-transcriptsDelete all room transcripts
delete-session-summariesDelete AI summaries
delete-room-summariesDelete all room summaries
export-room-transcriptsExport room transcripts
export-chat-messagesExport chat history
export-qa-dataExport Q&A data
export-session-transcriptsExport transcripts
export-poll-resultsExport poll results

Poll Management (6 tools)

ToolDescription
create-pollCreate a new poll
update-pollUpdate poll settings
delete-pollDelete a poll
delete-session-pollsDelete session polls
delete-room-pollsDelete all room polls
publish-poll-resultsPublish results

Content Library (26 tools)

ToolDescription
list-librariesList all libraries
get-library-detailsGet library details
create-libraryCreate a library
update-libraryUpdate library
delete-libraryDelete a library
get-library-hierarchyGet folder structure
list-library-foldersList folders
get-library-folder-detailsFolder details
create-library-folderCreate folder
update-library-folderUpdate folder
delete-library-folderDelete folder
list-library-filesList files
get-library-file-detailsFile details
create-library-fileUpload file
update-library-fileUpdate file
delete-library-fileDelete file
get-file-linksGet viewing links
create-webappCreate webapp
create-whiteboardCreate whiteboard
move-library-fileMove file
move-library-folderMove folder
copy-library-contentCopy content
bulk-delete-library-filesBulk delete
bulk-upload-library-filesBulk upload

Role & Permission Management (6 tools)

ToolDescription
get-rolesList all roles
get-roleGet role details
create-roleCreate custom role
update-roleUpdate role
delete-roleDelete role
get-permissionsList permissions

Webhook Management (6 tools)

ToolDescription
list-webhook-eventsAvailable events
list-webhooksList webhooks
get-webhookWebhook details
create-webhookCreate webhook
update-webhookUpdate webhook
delete-webhookDelete webhook

Export Tools (7 tools)

ToolDescription
export-chat-messagesExport chat
export-qa-dataExport Q&A
export-session-transcriptsExport transcripts
export-poll-resultsExport polls
export-recording-metadataExport recording data
export-session-summaryExport summary
export-session-metadataExport metadata

Troubleshooting

Authentication Issues

  • "Not authorized" error: Ensure you have Admin role on your Digital Samba team
  • OAuth redirect fails: Check your browser allows popups from claude.ai
  • Token expired: Reconnect - tokens auto-refresh but may require re-authentication after 24 hours

Common Issues

  • "Room not found": Verify the room ID is correct and hasn't been deleted
  • "Rate limit exceeded": Wait a few minutes and try again
  • Tools not appearing: Restart your AI assistant after adding the server

Getting Help

Authentication

The MCP server uses OAuth 2.0 with Digital Samba as the identity provider. When you connect:

  1. Your AI assistant redirects you to Digital Samba login
  2. You authenticate with your Digital Samba credentials
  3. The MCP server receives authorization to act on your behalf
  4. All API calls use your account's permissions

Requirements:

  • You must have Admin role on your Digital Samba team
  • OAuth tokens are valid for 24 hours and auto-refresh

For Developers

Local Development

If you want to run a local instance for development:

git clone https://github.com/digitalsamba/embedded-api-mcp-server.git
cd embedded-api-mcp-server
npm install
npm run dev -- --developer-key YOUR_DEVELOPER_KEY

Contributing

We welcome contributions! Please see our Contributing Guide for details.

API Reference

npm Package (Deprecated)

Note: The npm package @digitalsamba/embedded-api-mcp-server is deprecated. Please use the hosted MCP server at https://mcp.digitalsamba.com instead. The hosted version provides a better experience with OAuth authentication—no API keys to manage, no installation required.

If you have the npm package installed, it will continue to work but will not receive updates.

Support

License

MIT License - see LICENSE for details.

Related Servers