Vonage Assist

🚀 Vonage AI Code Assistant MCP Server

The Vonage AI Code Assistant MCP Server is a developer - centric tool designed to facilitate the integration of Vonage API features into applications. It leverages FastMCP to offer AI - assisted capabilities, enabling developers to quickly access Vonage's official documentation and efficiently find information related to Vonage communication APIs.

🚀 Quick Start

✨ Features

• Document Search: The server provides a dedicated tool named "Vonage - Assist" for searching in Vonage's official documentation.
• Integrated Web Search: Through the Google Serper API, the tool can perform targeted searches within the specific domain of Vonage developer documentation (developer.vonage.com/en/documentation).
• Content Extraction: When a user submits a search query, the server constructs a site - specific search request, sends it to the Google Serper API, receives search results with relevant document links, fetches content from these links, and returns the extracted text to the user.
• MCP Tool Integration: The server is compatible with Claude and other AI assistants supporting the MCP protocol, allowing these AI systems to directly use Vonage documentation to generate responses.

📦 Installation

To run the Vonage Assist MCP Server, follow these steps:

1. Ensure Python 3.13 or a higher version is installed.
2. Configure the required environment variables:
   • SERPER_API_KEY: The API key for Google Serper (required for web search).
3. Install dependencies:

uv install

4. Start the server:

python main.py

💻 Usage Examples

After the server is running, the "Vonage - Assist" tool can be used with the following parameters:

• query: The search query (e.g., "Number Verification", "SMS API").
• library: The document library to search (currently only "vonage" is supported).

Example of using the tool (via an MCP - compatible AI):

Use the Vonage - Assist tool to find information on how to implement two - factor authentication in the Vonage API.

🔧 Technical Details

The server is built using the following technologies:

• FastMCP: For the MCP server framework.
• httpx: For asynchronous HTTP requests.
• BeautifulSoup: For HTML parsing and text extraction.
• python - dotenv: For environment variable management.

The core functions are implemented through the following key functions:

• search_web(): Executes API requests to Google Serper.
• fetch_url(): Retrieves and extracts content from web pages.
• vonage_docs(): The main tool function that coordinates the search and content retrieval process.

Future Considerations

Potential improvement directions for the Vonage Assist MCP Server:

1. Code Generation Tool: Add functionality to generate sample code snippets for common Vonage API integrations (e.g., SMS, Voice, Verification, Video) in multiple programming languages, helping developers quickly implement Vonage features while following correct syntax and best practices.
2. API Parameter Assistant: Develop a tool to assist developers in constructing effective API requests by suggesting parameters, validating inputs, and explaining the required and optional fields of different Vonage API endpoints.
3. Troubleshooting Assistant: Implement functionality to diagnose common integration issues by analyzing error codes and providing feasible solutions based on knowledge - base articles and documentation, significantly reducing debugging time.
4. Gateway Configuration Assistant: Create a tool to assist in setting up and testing gateway endpoints for Vonage services, guiding developers through handling callbacks and events.
5. Best - Practice Advisor: Add functionality to provide context - relevant best - practice suggestions, helping developers build more robust applications in terms of performance, security, and resilience.
6. Rate - Limit and Pricing Estimator: Provide tools to help developers estimate costs and understand rate limits based on specific usage scenarios.