Vonage Assist MCP server

The Vonage AI Code Assist MCP server provides AI-assisted access to Vonage documentation, helping developers integrate Vonage API capabilities into their applications. It leverages FastMCP to search through official Vonage documentation and deliver relevant information about Vonage's communication APIs directly to AI assistants that support the MCP protocol.

Prerequisites

Before installing the Vonage AI Code Assist MCP server, ensure you have:

• Python 3.13 or higher installed
• A Google Serper API key (required for web searches)

Installation

Follow these steps to set up the Vonage AI Code Assist MCP server:

1. Clone the repository to your local machine

2. Set up the required environment variable:

   • SERPER_API_KEY: Your API key for Google Serper

3. Install the dependencies using UV:

   uv install
   

4. Start the server:

   python main.py
   

Using the MCP Server

Once running, the server exposes the "Vonage-Assist" tool that can be used with any MCP-compatible AI assistant like Claude.

Tool Parameters

The Vonage-Assist tool accepts the following parameters:

• query: The search query (e.g., "number verification", "SMS API")
• library: The documentation library to search (currently only "vonage" is supported)

Example Queries

Here are some examples of how to use the Vonage-Assist tool:

• Search for information about implementing two-factor authentication:

  Use the Vonage-Assist tool to find information about implementing two-factor authentication with Vonage APIs.
  

• Look up SMS API documentation:

  Use the Vonage-Assist tool to search for "SMS API" documentation.
  

• Find information about voice calls:

  Use the Vonage-Assist tool to find information about making voice calls with Vonage.
  

How the Tool Works

When you submit a query through the Vonage-Assist tool:

1. The server formulates a site-specific search query for the Vonage developer documentation domain (developer.vonage.com/en/documentation)
2. It sends this query to Google Serper API
3. The server receives search results with relevant documentation links
4. It fetches the content from these links
5. The extracted text content is returned to your AI assistant

This workflow allows the AI assistant to access up-to-date Vonage documentation directly and incorporate it into responses.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "vonage-assist" '{"command":"python","args":["main.py"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "vonage-assist": {
            "command": "python",
            "args": [
                "main.py"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "vonage-assist": {
            "command": "python",
            "args": [
                "main.py"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect