APPSOCOMDocs

AI assistants (MCP)

Connect Claude, ChatGPT, Gemini, Microsoft Copilot, Cursor, VS Code, Windsurf or any other app that supports the Model Context Protocol (MCP) to your Appsocom Live account. Your assistant can then work with your projects for you: mint a join token to test a room, find out why a call was poor, read call logs, manage API keys and the webhook, and answer questions from these docs.

To put an assistant inside your own app for your users, see AI assistant in your app.

Connect

The server URL is:

text
https://app.appsocom.dev/mcp

Add it as a custom connector (a remote MCP server) and sign in with your Appsocom Live account when asked.

App Where
Claude (web, desktop, mobile) Settings → Connectors → Add custom connector
Claude Code claude mcp add --transport http appsocom https://app.appsocom.dev/mcp
ChatGPT Settings → Apps → Create (developer mode)
Cursor Settings → MCP → Add a new MCP server, type HTTP
VS Code Command palette → MCP: Add Server → HTTP

When you sign in you choose what the assistant may do and which projects it reaches:

  • See your projects: projects, usage, call logs and quality, rooms, recordings, transcripts, billing and the docs. Always included.
  • Make changes in your projects: create projects and API keys, mint join tokens, control rooms, record, set the webhook.
  • See your mail setup and Manage your mail: only shown when your account has an Appsocom Mail org.
  • All projects (including ones you create later) or only the projects you tick.

The console's Assistants page lists every connected app. Disconnect stops it at once.

Tools

Tool What it does
list_projects, get_project Your projects, their limits and this month's usage
list_calls, get_call Recent calls and one call's per-minute quality: packet loss, round-trip time, jitter, how each person left
get_room, get_attendance Who's in a room or waiting, its settings, who attended
list_recordings, get_transcript, list_polls Recordings, caption transcripts, polls and Q&A
list_api_keys, get_webhook, get_billing Keys (never their secrets), webhook URL, credit and charges
search_docs, read_doc Search and read these docs
create_project, create_api_key New project or key. The secret is shown once.
create_join_token A join token for a room, with a role (teacher, student…), lobby, size limit
update_room, admit_waiting, send_chat_message, mute_participant Room controls
start_recording, stop_recording, set_captions, summarize_room Recording, captions and AI summaries
set_webhook, send_test_webhook Webhook URL and a signed test event
remove_participant, end_room, delete_api_key These can't be undone, so the assistant must ask you first

Mail tools (mail_…) list and add domains with their DNS records, and create, change and delete mailboxes and mail admins.

Safety

  • The assistant acts as you, but only within what you approved, and every call is checked again: a deleted project or a disconnected app stops working at once.
  • Anything that deletes or ends something needs the assistant to call the tool a second time with confirm: true, after asking you.
  • API keys and mailbox passwords created through an assistant are shown once, in that chat. Store them as server-side secrets.
  • Paid features (recording, captions, AI summaries) are charged to your credit as usual.

For developers

The server speaks MCP over Streamable HTTP (protocol versions 2024-11-05 to 2025-11-25) and OAuth 2.1 with PKCE, dynamic client registration and Client ID Metadata Documents. Discovery starts at https://app.appsocom.dev/.well-known/oauth-protected-resource/mcp. Scopes: live:read, live:write, mail:read, mail:write.