# Agora MCP for AI Agents AI Agent Connect > Agora MCP lets you manage real-time video and voice channels directly through your AI agent. You can start cloud recordings, check project usage stats, and list active users without leaving your chat interface. It handles the heavy lifting of RTC infrastructure management so you can focus on the user experience. ## Overview - **Category:** infrastructure - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_FG7jWuo7igounBgXwrQcgMdM1EHVulxOuhvr1Gsv/ai-agent-connect - **Tags:** agora-rtc, real-time-video, voice-chat, cloud-recording, streaming-api, interactive-engagement ## Description Managing real-time communication infrastructure usually involves jumping between multiple dashboards and console tabs. You have to hunt for AppIDs, check if a recording actually started, and dig through logs to see how many minutes of video you've burned through. This Connector changes that by letting your AI agent handle the backend work for you. Instead of manual clicking, you just ask your agent to start a recording for a specific webinar or check the peak concurrency for your last live stream. It handles the project configurations and channel rules so you can manage your streaming environment through simple commands. You can even query your monthly consumption reports to see exactly where your bandwidth is going. By connecting this to the Vinkius catalog, you get a unified way to keep your live engagement platform running smoothly without the usual administrative friction. You get a command line for your live streaming infrastructure that works wherever your agent does. ## Tools ### acquire_cloud_recording Request a resource ID before you start a recording. This is a required step for cloud recording tasks. ### create_project Set up a brand new Agora project from your agent. This speeds up the deployment of new streaming apps. ### get_project_details Pull specific configurations and IDs for a project. This saves you from hunting through the console settings. ### get_usage_stats Get detailed data on minutes and bandwidth usage. This helps you track your real-time costs. ### list_active_calls See all ongoing calls and sessions in your project. This helps you monitor live activity at a glance. ### list_projects Get a full list of all Agora projects in your console. Use this to see your entire project portfolio. ### list_whiteboard_rooms Find all active Interactive Whiteboard rooms. This is useful for managing collaborative spaces. ### query_cloud_recording Check if a specific cloud recording is still running or done. This helps you verify recording success. ### start_cloud_recording Trigger a new cloud recording for a specific channel. This automates your archival workflow. ### stop_cloud_recording End an ongoing cloud recording session immediately. Use this to stop recording when a stream finishes. ## Prompt Examples **Prompt:** ``` Can you start a cloud recording for my 'Summer_Webinar' channel? ``` **Response:** ``` Initializing Agora cloud recording for the 'Summer_Webinar' channel... **Success!** The recording session has started. * **Resource ID:** `res_99283x` * **Session ID:** `sid_v8821` I'll keep an eye on the status for you. Would you like me to notify you when it's finished? ``` **Prompt:** ``` What's our total video usage for the last week? ``` **Response:** ``` Fetching your usage stats for the current project... **Usage Summary (Last 7 Days):** | Metric | Total | Peak | | :--- | :--- | :--- | | Video Minutes (HD) | 1,420 | 45 | | Audio Minutes | 310 | 12 | | Peak Concurrency | 88 users | - Your bandwidth usage peaked on Wednesday during the live demo. ``` **Prompt:** ``` List all the active projects I have in Agora. ``` **Response:** ``` Retrieving your project list... Here are your active Agora projects: 1. **Production_App** (AppID: `app_prod_01`) 2. **Staging_Environment** (AppID: `app_stg_99`) 3. **Internal_Testing** (AppID: `app_test_04`) Would you like to see the specific details for any of these? ``` ## Capabilities ### Start cloud recordings Trigger a new cloud recording session for a specific channel. ### Check recording status See if a specific cloud recording is currently active or finished. ### List active users See who is currently connected to a specific RTC session. ### Query usage stats Get data on minutes consumed and bandwidth peaks for your projects. ### Create new projects Set up a brand new Agora project with specific IDs from your agent. ### Manage whiteboard rooms Find all active Interactive Whiteboard sessions across your account. ### List active calls View all ongoing voice or video sessions in your project. ## Use Cases ### Automating webinar recordings A live streamer needs to start a recording for a 2-hour webinar. They ask their agent to use acquire_cloud_recording and start_cloud_recording for the specific channel. ### Real-time budget monitoring An engineer needs to know if the current stream is over budget. They ask the agent to pull get_usage_stats for the current project to see current bandwidth consumption. ### Portfolio project auditing A product manager needs a list of all active projects. They ask the agent to list_projects to see the full portfolio and project IDs. ### Live user tracking A support lead needs to see who is currently in a specific room. They ask the agent to list_active_users to get a list of connected UIDs. ## Benefits - Automate recording workflows using start_cloud_recording so you don't have to manually trigger sessions. - Track real-time costs with get_usage_stats to see exactly how many minutes you're burning. - Manage project settings quickly with create_project and get_project_details without opening the console. - Monitor live engagement by using list_active_calls and list_active_users to see who's online. - Simplify whiteboard management by listing all active rooms with list_whiteboard_rooms. ## How It Works The bottom line is you get a command line for your live streaming infrastructure. 1. Get your Customer ID, Secret, and AppID from the Agora Console. 2. Plug those credentials into your Connector configuration. 3. Ask your agent to perform actions like starting recordings or checking stats. ## Frequently Asked Questions **Can the Agora MCP start recordings automatically?** Yes, it can trigger cloud recordings for specific channels. You just need to tell your agent which channel to record, and it handles the request for you. **How do I check my real-time video usage?** You can ask your agent to pull usage stats for any project. It will return data on minutes consumed and peak concurrency so you can track your costs. **Can I manage multiple Agora projects with this?** Yes, you can list and inspect all projects in your console. This makes it easy to manage a large portfolio of streaming apps from one place. **Does this help with live whiteboard rooms?** Yes, it can list all active Interactive Whiteboard sessions. This is great for monitoring collaborative spaces in real-time. **Is there a way to see who's currently in a call?** Yes, the Connector can list active users and sessions. You can ask your agent to see who is currently connected to a specific RTC room. **How do I get my credentials for the Agora MCP?** You'll need to log into the Agora Console, go to Project Management, and find your Customer ID, Customer Secret, and AppID in the settings. **Can I automatically list all active users in an Agora channel?** Yes! Use the `list_channel_users` tool with the project AppID and the target Channel Name. Your agent will return a list of UIDs currently connected to that session. **How do I start a cloud recording session via the AI agent?** Use the `start_cloud_recording` tool with the necessary parameters (AppID, Channel Name, and recording config). The agent will trigger the Agora cloud recording engine and return the Resource ID and SID. **Can I monitor the total minutes consumed by my project this month?** Yes! The `get_usage_metrics` tool retrieves granular consumption data, including audio and video minutes, filtered by date range or project.