Skip to content

digitalsamba/embedded-api-mcp-server

Repository files navigation

Digital Samba Embedded API MCP Server

Digital Samba Logo

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 john@example.com"
"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:

Assistant Server URL
Claude Desktop https://mcp.digitalsamba.com
ChatGPT https://mcp.digitalsamba.com
Other MCP Clients https://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)

Tool Description
create-room Create a new room
update-room Update room settings
delete-room Delete a room
generate-token Generate participant access token
get-default-room-settings Get default settings
update-default-room-settings Update default settings
list-rooms List all rooms
get-room-details Get room details
list-live-rooms List rooms with active sessions
list-live-participants List all live participants
get-room-live-info Get live session info for a room

Session Management (12 tools)

Tool Description
list-sessions List all sessions
get-session-summary Get session details
list-session-participants List session participants
get-session-statistics-details Detailed session stats
list-room-sessions Sessions for a specific room
end-session End a live session
delete-session-recordings Delete session recordings
delete-session-resources Delete session resources
hard-delete-session-resources Permanently delete data
bulk-delete-session-data Bulk delete operations
list-room-transcripts List room transcripts
list-session-transcripts List session transcripts

Recording Management (10 tools)

Tool Description
get-recordings List recordings with filters
get-recording Get recording details
delete-recording Delete a recording
get-recording-download-link Get download URL
archive-recording Archive a recording
unarchive-recording Restore archived recording
get-archived-recordings List archived recordings
get-room-recordings Recordings for a room
get-recording-bookmarks Get recording bookmarks
bulk-delete-recordings Delete multiple recordings

Live Session Controls (8 tools)

Tool Description
start-recording Start recording a session
stop-recording Stop recording
start-transcription Start live transcription
stop-transcription Stop transcription
raise-participant-hand Raise a participant's hand
lower-participant-hand Lower a participant's hand
raise-phone-participant-hand Raise phone participant hand
lower-phone-participant-hand Lower phone participant hand

Analytics Tools (8 tools)

Tool Description
get-team-statistics Team-wide metrics
get-room-analytics Room usage analytics
get-usage-statistics Overall usage stats
get-participant-statistics Participant analytics
get-session-analytics Session analytics
get-live-analytics Live session metrics
get-live-room-analytics Live metrics for a room
get-participant-analytics Specific participant stats

Communication Management (13 tools)

Tool Description
delete-session-chats Delete session chat
delete-room-chats Delete all room chats
delete-session-qa Delete session Q&A
delete-room-qa Delete all room Q&A
delete-session-transcripts Delete session transcripts
delete-room-transcripts Delete all room transcripts
delete-session-summaries Delete AI summaries
delete-room-summaries Delete all room summaries
export-room-transcripts Export room transcripts
export-chat-messages Export chat history
export-qa-data Export Q&A data
export-session-transcripts Export transcripts
export-poll-results Export poll results

Poll Management (6 tools)

Tool Description
create-poll Create a new poll
update-poll Update poll settings
delete-poll Delete a poll
delete-session-polls Delete session polls
delete-room-polls Delete all room polls
publish-poll-results Publish results

Content Library (26 tools)

Tool Description
list-libraries List all libraries
get-library-details Get library details
create-library Create a library
update-library Update library
delete-library Delete a library
get-library-hierarchy Get folder structure
list-library-folders List folders
get-library-folder-details Folder details
create-library-folder Create folder
update-library-folder Update folder
delete-library-folder Delete folder
list-library-files List files
get-library-file-details File details
create-library-file Upload file
update-library-file Update file
delete-library-file Delete file
get-file-links Get viewing links
create-webapp Create webapp
create-whiteboard Create whiteboard
move-library-file Move file
move-library-folder Move folder
copy-library-content Copy content
bulk-delete-library-files Bulk delete
bulk-upload-library-files Bulk upload

Role & Permission Management (6 tools)

Tool Description
get-roles List all roles
get-role Get role details
create-role Create custom role
update-role Update role
delete-role Delete role
get-permissions List permissions

Webhook Management (6 tools)

Tool Description
list-webhook-events Available events
list-webhooks List webhooks
get-webhook Webhook details
create-webhook Create webhook
update-webhook Update webhook
delete-webhook Delete webhook

Export Tools (7 tools)

Tool Description
export-chat-messages Export chat
export-qa-data Export Q&A
export-session-transcripts Export transcripts
export-poll-results Export polls
export-recording-metadata Export recording data
export-session-summary Export summary
export-session-metadata Export 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.



Digital Samba

Built with care by the Digital Samba team