# Webex — how to use (mcp.ai)

Webex is a Cisco-powered video conferencing and collaboration platform offering online meetings, webinars, screen sharing, and team messaging

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_webex?ms=1781541840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `webex_create_room`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/webex`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/webex/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/webex/create/room` — Tool to create a new room. use when you need to spin up a dedicated space for team collaboration or topic discussion.
  - body: { title: string, teamId?: string }
- `POST https://api.mcp.ai/api/webex/create/team` — Tool to create a new team. use when you need to group rooms under a shared team.
  - body: { name: string, description?: string }
- `POST https://api.mcp.ai/api/webex/get/team/details` — Tool to retrieve details for a specific team by teamid. use when you need full metadata of a team before performing team-related operations.
  - body: { teamId: string }
- `POST https://api.mcp.ai/api/webex/list/teams` — Tool to list teams. use when you need to retrieve the teams the authenticated user is a member of.
  - body: { max?: integer }
- `POST https://api.mcp.ai/api/webex/list/webhooks` — Tool to list webhooks. use after authentication to retrieve webhooks filtered by max or ownership.
  - body: { max?: integer, ownedBy?: string }
- `POST https://api.mcp.ai/api/webex/messaging/create/message` — Tool to post a message to a webex room or person. use when you have a target roomid or private recipient and want to send text, markdown, files, or card attachments.
  - body: { text?: string, files?: string[], roomId?: string, markdown?: string, toPersonId?: string, attachments?: object[], toPersonEmail?: string }
- `POST https://api.mcp.ai/api/webex/messaging/create/room` — Tool to create a new room. use to create a dedicated space for collaboration after authentication.
  - body: { title: string, teamId?: string }
- `POST https://api.mcp.ai/api/webex/messaging/create/team/membership` — Tool to add a person to a webex team by personid or personemail. use when granting a user access to a team; requires teamid and one of personid or personemail.
  - body: { teamId: string, personId?: string, isModerator?: boolean, personEmail?: string }
- `POST https://api.mcp.ai/api/webex/messaging/delete/membership` — Tool to delete a webex membership by its unique identifier. use when you need to remove a member from a space after confirming the membership exists. example: "delete the membership with id y2lzy29zcg
  - body: { membershipId: string }
- `POST https://api.mcp.ai/api/webex/messaging/delete/message` — Tool to delete a webex message by its unique identifier. use after confirming the messageid to remove unintended or obsolete messages. example: "delete the message with id y2lzy29zcgfyazovl21lc3nhz2uv
  - body: { messageId: string }
- `POST https://api.mcp.ai/api/webex/messaging/delete/room` — Tool to delete a webex room by its id. use after confirming the roomid when you need to permanently remove or archive a space. example: "delete the room with id y2lzy29..."
  - body: { roomId: string }
- `POST https://api.mcp.ai/api/webex/messaging/get/membership/details` — Tool to retrieve details for a specific membership. use when you need metadata for a membership by its id.
  - body: { membershipId: string }
- `POST https://api.mcp.ai/api/webex/messaging/get/message/details` — Tool to retrieve details for a specific message. use when you need full content and metadata by message id.
  - body: { messageId: string }
- `POST https://api.mcp.ai/api/webex/messaging/get/room/details` — Tool to retrieve details for a specific room. use when you need full metadata of a specific room before posting messages or updating settings.
  - body: { roomId: string }
- `POST https://api.mcp.ai/api/webex/messaging/get/team/membership/details` — Tool to retrieve details for a specific team membership. use when you need metadata for a team membership by its id.
  - body: { membershipId: string }
- `POST https://api.mcp.ai/api/webex/messaging/list/memberships` — Tool to list memberships in a webex room. use when you need to retrieve or filter membership details by roomid, personid, personemail, or teamid. supports limiting the response size.
  - body: { max?: integer, roomId?: string, teamId?: string, personId?: string, personEmail?: string }
- `POST https://api.mcp.ai/api/webex/messaging/list/messages` — Tool to list messages in a room. use when you need to retrieve chat history filtered by room, time window, or mentions.
  - body: { max?: integer, before?: string, roomId: string, parentId?: string, beforeMessage?: string, mentionedPeople?: string[] }
- `POST https://api.mcp.ai/api/webex/messaging/list/rooms` — Tool to list rooms the authenticated user belongs to. use after authentication when needing to retrieve spaces filtered by team, type, or sorted. example: "list my group rooms sorted by last activity.
  - body: { max?: integer, type?: string, sortBy?: string, teamId?: string }
- `POST https://api.mcp.ai/api/webex/messaging/list/team/memberships` — Tool to list team memberships. use when you need to retrieve or filter team membership details by teamid, personid, or personemail, with optional max limit. use after confirming the team or person con
  - body: { max?: integer, teamId?: string, personId?: string, personEmail?: string }
- `POST https://api.mcp.ai/api/webex/people/get/person` — Tool to get details for a specific person. use when you have a person's id and need full profile information. call after confirming the person's id.
  - body: { personId: string, callingData?: boolean }
- `POST https://api.mcp.ai/api/webex/people/list/people` — Tool to list people in your organization. use when you need to retrieve people filtered by email, display name, ids, roles, or location.
  - body: { id?: string, max?: integer, email?: string, orgId?: string, roles?: string, locationId?: string, callingData?: boolean, displayName?: string }
- `POST https://api.mcp.ai/api/webex/rooms/get/room/details` — Tool to retrieve details for a specific room. use when you need full metadata of a room before posting messages or updating settings.
  - body: { roomId: string }
- `POST https://api.mcp.ai/api/webex/update/membership` — Tool to update a membership by membershipid. use when modifying a member's moderator or monitor status in a webex room.
  - body: { isMonitor?: boolean, isModerator?: boolean, membershipId: string }
- `POST https://api.mcp.ai/api/webex/update/room` — Tool to update a room's title and settings. use when you need to rename, lock/unlock, or reassign a webex space.
  - body: { title?: string, roomId: string, teamId?: string, isLocked?: boolean }
- `POST https://api.mcp.ai/api/webex/update/team` — Tool to update a team's name by teamid. use when you need to rename a webex team. example: "change team 12345 name to 'project x team'".
  - body: { name: string, teamId: string }
- `POST https://api.mcp.ai/api/webex/webhooks/create/webhook` — Tool to create a new webhook for events. use when you need to register for webex event notifications.
  - body: { name: string, appId?: string, event: string, filter?: string, secret?: string, ownedBy?: string, resource: string, targetUrl: string }
- `POST https://api.mcp.ai/api/webex/webhooks/delete/webhook` — Tool to delete a specific webhook. use when you need to remove an existing webhook by its id after confirming the identifier.
  - body: { webhookId: string }
- `POST https://api.mcp.ai/api/webex/webhooks/get/webhook` — Tool to get details for a specific webhook. use when you need to inspect a webhook's configuration before taking action.
  - body: { webhookId: string }

## More
- Page: https://mcp.ai/webex
- Agent spec (llms.txt): https://mcp.ai/webex/llms.txt
- Postman collection: https://mcp.ai/webex/postman.json