mcp-server-webex-docs

Webex API Docs MCP Server (webex-api-docs-mcp)

An MCP (Model Context Protocol) server providing fast, local full-text search and complete OpenAPI JSON schemas for all Webex Developer APIs & RoomOS xAPI.

💡 What Problem Does This Solve? (Why Use This MCP Server?)

🔴 The Problem: Hallucinations & Massive Token Cost

When AI Agents or developers work with Webex APIs, they face three major bottlenecks:

- LLM Hallucinations:Large language models frequently guess incorrect HTTP methods, outdated REST paths, or invent required OAuth scopes (spark-admin:...) that lead to401 Unauthorizedor404 Not Founderrors.
- Context Window Exhaustion:The official Webex OpenAPI and RoomOS xAPI specifications span over4,500 endpointsacross Admin, Calling, Meetings, Messaging, and RoomOS—equaling more than15 MB of raw documentation. Loading this into an LLM context window is slow, expensive, and impractical.
- Slow Web Scraping:Relying on live web searches to fetch developer documentation during an agentic coding workflow causes latency and fragile HTML parsing.

🟢 The Solution: Zero-Token Local Search & Exact Schemas

This MCP server acts as anauthoritative, local technical referencefor your AI Assistant. Instead of guessing or browsing the web, the AI can query the localSQLite FTS5 database in <5 milliseconds, discover the exact endpoint, and retrieve its complete, verified OpenAPI JSON schema on demand.

Here are examples of questions and tasks your AI Agent can solve instantly using this MCP server:
- 🔒 Security & Admin Audit Logging

- User Prompt:"I need to write a script that logs who deleted a user account in Webex Control Hub. What endpoint should I call and what permissions do I need?"

- MCP Action:Usessearch_webex_api_docs("audit events")-> ReturnsGET /adminAudit/events-> Usesget_webex_endpoint_schemato inspectactorEmail,eventDescription, and the requiredaudit:events_readscope.

- User Prompt:"How do I programmatically create an AI Receptionist Knowledge Base in Webex Calling?"

- MCP Action:Usessearch_webex_api_docs("knowledge base")-> LocatesPOST /telephony/config/knowledgeBases-> Retrieves the exact JSON Request Body schema showing mandatory fields (name,description).

- User Prompt:"What is the REST API path to download post-meeting transcripts and AI summaries?"

- MCP Action:Searchesmeetingsdomain for"transcripts"-> FindsGET /meetings/{meetingId}/transcriptsandGET /meetings/{meetingId}/summariesalong with query parameters.

- User Prompt:"I want my bot to receive real-time notifications when a message is posted in a Webex room."

- MCP Action:LocatesPOST /webhooksin themessagingdomain and returns the required payload structure formessages/createdevents.

- User Prompt:"How do I control AirPlay or adjust volume on a Cisco Room Bar using xAPI?"

- MCP Action:Searchesroomosdomain -> FindsxCommand AirPlay KeyEvent BackandxCommand Audio Volume Set-> Retrieves syntax for Webex Cloud REST API (POST /v1/xapi/command/...), Node.jsjsxapi, and on-device CLI/Macros.

🌟 Why This Architecture? (Dual-Layer Documentation)

This repository implements ascalable, reproducible, and Git-versioned documentation pipelinedesigned specifically for AI Agents and developers:
- Layer 1: Markdown Artifacts in Git (docs/<domain>.md)

- Clean, structured Markdown documentation forWebex Admin, Webex Cloud Calling, Webex Meetings, Webex Messaging, and Webex RoomOS xAPIis generated automatically and stored in/docs/.

- Every time Webex updates an API, running the ETL pipeline produces a standard Git diff so you can track API changes over time.

- An optimized SQLite relational database managed viaSQLAlchemy 2.0 ORMcombined withSQLite FTS5 (Full-Text Search).

- Provides sub-millisecond keyword and semantic search across4,539 endpointswithout loading multi-megabyte files into memory or context.

The server indexes4,539 official Webex endpointsacross 5 major service domains:
- Clone the repository and install dependencies:

git clone https://github.com/santime27/mcp-server-webex-docs.git cd mcp-server-webex-docs pip install -r requirements.txt

🔌 How to Connect This MCP Server (Configuration)

Thanks to automatic path resolving insrc/server.py, connecting this server to any MCP client isultra-simple—noPYTHONPATH,cwd, or-mflags required!

1. Gemini CLI / Google Antigravity / Gemini Code Assist

Add this to your Gemini MCP settings file (e.g.,~/.gemini/settings.jsonor your project's MCP configuration):

{ "mcpServers": { "webex-api-docs": { "command": "python3", "args": [ "/path/to/mcp-server-webex-docs/src/server.py" ] } } }

2. Claude Desktop / Cursor / Generic MCP Client (claude_desktop_config.json)

{ "mcpServers": { "webex-api-docs": { "command": "python3", "args": [ "/path/to/mcp-server-webex-docs/src/server.py" ] } } }

Note: Replace/path/to/mcp-server-webex-docswith the absolute path where you cloned this repository on your machine.

When connected to an MCP client (such as Claude Desktop, Antigravity, or custom agents), this server exposes the following tools:

- search_webex_api_docs(query, domain=None, category=None, limit=15)

- Sub-millisecond FTS5 search across all 1,456 endpoints. Returns endpoint titles, HTTP method/path, summary, and exact line numbers in the documentation file.

- Reads the exact line range fromdocs/<domain>.mdand returns the complete OpenAPI JSON schema, parameter table, required scopes, and HTTP response codes for a specific endpoint.

- Lists the 4 available Webex domains and their endpoint counts.

- Lists all categories available within a specific domain.

mcp-server-webex-docs/ ├── agent-skills/ # AI Agent Skills (instructions & templates) │ └── webex-api-assistant/ # Methodology for discovering, inspecting, and exploring APIs │ ├── SKILL.md │ ├── examples/ │ │ └── explorer_template.py │ └── references/ │ └── webex_api_cheatsheet.md ├── docs/ # Git-versioned Markdown documentation │ ├── admin.md │ ├── calling.md │ ├── meetings.md │ ├── messaging.md │ └── roomos.md # Webex RoomOS xAPI Commands, Configurations, Statuses & Events ├── data/ │ ├── roomos_schema.json # Cached official RoomOS xAPI schema (3,083 objects) │ └── webex_docs.db # SQLite FTS5 database indexed via SQLAlchemy ├── src/ │ ├── models/ # SQLAlchemy ORM models (Domain, Category, Endpoint) │ │ ├── __init__.py │ │ └── db.py │ ├── pipeline/ # ETL pipeline for automated updates │ │ ├── __init__.py │ │ ├── build_all.py # Main orchestrator CLI │ │ ├── db_indexer.py # SQLite FTS5 indexer │ │ ├── fetcher.py # Developer portal state extractor │ │ ├── markdown_builder.py# Markdown generator (Admin, Calling, Meetings, Messaging) │ │ └── roomos_builder.py # RoomOS xAPI schema & Markdown generator │ ├── __init__.py │ └── server.py # MCP FastMCP server implementation ├── requirements.txt

🧠 AI Agent Skill (agent-skills/webex-api-assistant)

This repository includes an officialAgent Skillinagent-skills/webex-api-assistant/SKILL.mddesigned to teach any AI Assistant (such as Antigravity, Claude, or Cursor) how to act as aSenior Webex Developer Companion.
- The 2-Step MCP Workflow:Always discovering APIs viasearch_webex_api_docsfirst, then inspecting full OpenAPI schemas and OAuth scopes viaget_webex_endpoint_schema.
- Interactive Sandbox Exploration:Generating and executing clean Python exploration scripts in a sandbox/temporary environment to test live APIs.
- Security Best Practices:ReadingWEBEX_ACCESS_TOKENfrom environment variables without ever hardcoding tokens.

Built with ❤️ by , Software Engineer, in pair-programming collaboration withAntigravity(Google DeepMind Agentic AI Assistant).

This project is licensed under the permissiveMIT License— feel free to use, copy, modify, distribute, and build upon this software for both personal and commercial projects without restrictions.

Up-to-date documentation for your coding agent. Covers 1000s of public repos and sites. Built by ref.tools