home / mcp / messages api mcp server

Messages API MCP Server

Provides an MCP server exposing the Nexmo Messages Olympus API with configurable Python-based runtime and transport options.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ag2-mcp-servers-messages-api": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "A JSON string containing the configuration.",
        "SECURITY": "Environment variables for security parameters (e.g., API keys).",
        "CONFIG_PATH": "Path to a JSON configuration file (e.g., mcp_server/mcp_config.json)"
      }
    }
  }
}

You can deploy this MCP server to expose a programmable interface for the Nexmo (Vonage) Messages Olympus API via the OpenAPI specification. It enables you to connect your MCP clients to the remote API with a consistent transport, lifecycle, and configuration surface.

How to use

To run the MCP server, start it in stdio mode so your client can interact through standard input and output. Use the Python runtime to launch the main entry point and specify the transport mode you want to use.

How to install

Prerequisites you must have before installing and running: Python 3.9+ and pip with uv installed.

Clone the project repository and enter the directory:

git clone <repository-url>
cd mcp-server

Install dependencies using the development extras to enable linting, tests, and tooling. Run this command from the project root:

pip install -e ".[dev]"

If you prefer using the UV tool to execute the installation, you can run this instead:

uv pip install --editable ".[dev]"

Additional setup notes

If you are using a development container, a helper script manages dependencies. If you are not, run the same installation step locally to install the editable package with its development extras.