Webex MCP server

Cisco Webex is a cloud collaboration platform that unifies messaging, video meetings, and file sharing into one application. An AI agent with access to Webex can manage spaces and teams, post messages and cards, schedule meetings, manage recordings, and retrieve transcripts without opening the Webex client.

Setting up an MCP server

This article covers the standard steps for creating an MCP server in AI Gateway and connecting it to an AI client. The steps are the same for every integration — application-specific details (API credentials, OAuth endpoints, and scopes) are covered in the individual application pages.

Before you begin

You'll need:

• Access to AI Gateway with permission to create MCP servers
• API credentials for the application you're connecting (see the relevant application page for what to collect)

Create an MCP server

Find the API in the catalog

1. Sign in to AI Gateway and select MCP Servers from the left navigation.
2. Select New MCP Server.
3. Search for the application you want to connect, then select it from the catalog.

Configure the server

1. Enter a Name for your server — something descriptive that identifies both the application and its purpose.
2. Enter a Description so your team knows what the server is for.
3. Set the Timeout value. 30 seconds works for most APIs; increase to 60 seconds for APIs that return large payloads.
4. Toggle Production mode on if this server will be used in a live workflow.
5. Select Next.

Configure authentication

Enter the authentication details for the application. This varies by service — see the Authentication section of the relevant application page for the specific credentials, OAuth URLs, and scopes to use.

Configure security

1. Set any Rate limits appropriate for your use case and the API's own limits.
2. Enable Logging if you want AI Gateway to record requests and responses for auditing.
3. Select Next.

Deploy

Review the summary, then select Deploy. AI Gateway provisions the server and provides a server URL you'll use when configuring your AI client.

---

Connect to an AI client

Once your server is deployed, you'll need to add it to the AI client your team uses. Select your client for setup instructions:

• Claude Desktop
• Claude Code
• Cursor
• VS Code
• Windsurf

Tips

• You can create multiple MCP servers for the same application — for example, a read-only server for reporting agents and a read-write server for automation workflows.
• If you're unsure which OAuth scopes to request, start with the minimum read-only set and add write scopes only when needed. Most application pages include scope recommendations.
• You can edit a server's name, description, timeout, and security settings after deployment without redeploying.

Authentication

Webex uses OAuth 2.0 authentication. Create an integration at developer.webex.com and configure the redirect URI for your AI Gateway. In the Webex developer portal, go to developer.webex.com/my-apps and click Create a New App to register your OAuth integration.

Value	Setting
Auth endpoint	https://webexapis.com/v1/authorize
Token endpoint	https://webexapis.com/v1/access_token
Base URL	https://webexapis.com/v1
Scopes	spark:messages_read, spark:messages_write, spark:rooms_read, spark:rooms_write, spark:people_read, spark:memberships_read, spark:memberships_write, spark:teams_read, spark:teams_write, meeting:schedules_read, meeting:schedules_write, meeting:recordings_read, meeting:transcripts_read

Available tools

This MCP server enables messaging, room and space management, meeting operations, recording access, transcript retrieval, and user directory operations for Webex workspaces.

Tool	Description
Send message	Post a message to a space with Markdown formatting or Adaptive Cards
Get message	Retrieve a specific message with metadata
Delete message	Remove a message from a space
List messages	Retrieve messages from a space with optional mention filtering
Create space	Create a new collaboration space or 1:1 direct message room
Update space	Modify space title and other settings
Get space	Retrieve space details including members and settings
Delete space	Remove a space and archive its content
Add member	Invite a person to a space by email or person ID
Remove member	Remove a member from a space
Get member	Retrieve information about a space member
List members	Retrieve all members of a space
Create team	Create a team to organize related spaces
Get team	Retrieve team information and member list
Delete team	Remove a team and associated spaces
Create meeting	Schedule a meeting with attendees and settings
Update meeting	Modify meeting details including agenda and password
Get meeting	Retrieve meeting information including join link
List meetings	Retrieve scheduled meetings with filtering
Delete meeting	Cancel a meeting
List recordings	Retrieve meeting recordings with metadata
Get recording	Retrieve download link and details for a recording
Delete recording	Remove a recording from the system
Get transcript	Retrieve full transcript of a meeting with speaker attribution
List transcripts	Retrieve available transcripts for meetings
Search user	Find users by email or name in the organization
Get user	Retrieve user profile and contact information
Create webhook	Subscribe to real-time events like messages and membership changes
Get webhook	Retrieve webhook details and configuration
Delete webhook	Remove a webhook subscription

Tips

Use Adaptive Cards for interactive messages — Webex Adaptive Cards enable interactive experiences like buttons and forms. Use them for approvals, surveys, and data collection instead of plain text messages.

Monitor X-RateLimit-Remaining in response headers and implement backoff when approaching limits to avoid request rejections. Webex includes rate limit information in response headers.

Only request the scopes your integration actually needs — this follows the principle of least privilege and makes your integration more trustworthy to users.

Set up webhooks for real-time updates instead of polling the API repeatedly, which is inefficient. Process only the events you care about.

Wait at least 5-10 minutes before retrieving recordings — recordings aren't available immediately after a meeting ends. This avoids not-found errors.

---