VOYP Call Automation

by paulotaylor

8 stars
239 downloads
Not rated
GitHub

About

Integrates with VOYP API to enable automated call handling, routing, and intelligent voice responses for enhanced call center operations.

Details

Author
paulotaylor
Repository
paulotaylor/voyp-mcp
GitHub stars
8
Downloads
239
License
MIT License
Categories
Communication, AI, Other, Productivity, Design, Developer Tools, Automation, Infrastructure
Tags
#integration, #mobile

- Construct call contexts for making calls
- Search business information for restaurants, dentists, etc.
- Make appointments, reservations, consultations, inquiries
- Monitor call progress and provide status
- Hangup active calls
- OAuth2 and API key authentication

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name VOYP Call Automation
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 voyp-mcp
    Environment
    • VOYP_API_KEY your-VOYP-api-key

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via Smithery, NPX, or Git; configure an MCP client like Claude Desktop with your Voyp API key. The server exposes tools such as start_call and hangup_call. A remote HTTP Streamable endpoint is also available at https://api.voyp.app/mcp/stream with OAuth2 or API key authentication.

start_call

Initiate a phone call using the Voyp MCP server.

hangup_call

End an ongoing phone call initiated through the Voyp MCP server.

construct_call_context

Create robust call contexts to use when making calls.

search_business_information

Search for business information when calling establishments like restaurants and dentists.

make_appointment

Call and make appointments, reservations, consultations, or inquiries.

get_call_status

Provide the status of the current call.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "voyp call automation": {
            "env": {
                "VOYP_API_KEY": "your-VOYP-api-key"
            },
            "args": [
                "-y",
                "voyp-mcp"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"
    },
    "args": [
        "/path/to/voyp-mcp/build/index.js"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"
    },
    "args": [
        "-y",
        "voyp-mcp"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "voyp-mcp"
    ],
    "command": "cmd"
}

The Model Context Protocol (MCP) is an open standard that enables AI systems to interact seamlessly with various data sources and tools, facilitating secure, two-way connections.

Developed by Anthropic, the Model Context Protocol (MCP) enables AI assistants like Claude to seamlessly integrate with VOYP's calling capabilities. This integration provides AI models with possibility of making phone calls and monitor their progress.

- Construct robust call contexts to use when making calls
- Search for business information when calling restaurants, dentists, etc...
- Call and make appointments, reservations, consultations, inquiries, etc...
- Provide status of the call
- Hangup call

- Voyp API key

- You will also need to buy credits to spend while making calls. You can also buy creditshere

- You can verify your Node.js installation by running:

- node --version

- On macOS:brew install git
- On Linux:

- Debian/Ubuntu:sudo apt install git
- RedHat/CentOS:sudo yum install git

Remote Voyp MCP server (Http Streamable)

You can connect directly to the stream-enabled endpoint here:

Voyp supports the OAuth2 authentication flow

You must add the Authorization header to your requests with your Voyp API Key or OAuth2 access tooken:

Voyp MCP server installation forGoose⚡ (Stdio)

To install the voyp-mcp server you will need to add the extension manually.

Voyp MCP server installation for Claude Desktop ⚡ (Stdio)

To install the voyp-mcp server, you can use the following methods:
- Installing via Smithery
- Running with NPX
- Git installation

To install Voyp Model Context Protocol server for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install @paulotaylor/voyp-mcp --client claude

Although you can launch a server on its own, it's not particularly helpful in isolation. Instead, you should integrate it into an MCP client. Below is an example of how to configure the Claude Desktop app to work with the voyp-mcp server.

# Create the config file if it doesn't exist touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json" # Opens the config file in TextEdit open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json" # Alternative method using Visual Studio Code (requires VS Code to be installed) code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
code %APPDATA%\Claude\claude_desktop_config.json

Replaceyour-VOYP-api-keywith your actualVOYP API key.

{ "mcpServers": { "voyp-mcp": { "command": "npx", "args": ["-y", "voyp-mcp"], "env": { "VOYP_API_KEY": "your-VOYP-api-key" } } } }
git clone https://github.com/paulotaylor/voyp-mcp.git cd voyp-mcp

Follow the configuration steps outlined in theConfiguring the Claude Desktop appsection above, using the below JSON configuration.

Replaceyour-VOYP-api-key-herewith your actualVOYP API keyand/path/to/voyp-mcpwith the actual path where you cloned the repository on your system.

{ "mcpServers": { "voyp": { "command": "npx", "args": ["/path/to/voyp-mcp/build/index.js"], "env": { "VOYP_API_KEY": "your-VOYP-api-key" } } } }

Once the installation is complete, and the Claude desktop app is configured, you must completely close and re-open the Claude desktop app to see the voyp-mcp server. You should see a hammer icon in the bottom left of the app, indicating available MCP tools, you can click on the hammer icon to see more details on the start_call and hangup_call tools.

Now claude will have complete access to the voyp-mcp server, including the start_call and hangup_call tools.

- Verify the npm installation by runningnpm --verison
- Check Claude Desktop configuration syntax by runningcode ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Ensure Node.js is properly installed by runningnode --version

- If you encounter errors related tonpx, you may need to use the full path to the npx executable instead.
- You can find this path by runningwhich npxin your terminal, then replace the"command": "npx"line with"command": "/full/path/to/npx"in your configuration.
- API Key Issues

- Confirm your VOYP API key is valid
- Check the API key is correctly set in the config
- Verify no spaces or quotes around the API key

- Model Context Protocolfor the MCP specification
-
Anthropicfor Claude Desktop

Upfirst is an AI phone receptionist for small businesses. Review call transcripts, then fix the greeting, knowledge, and transfer rules from your AI client.

Provides audio input and output capabilities for AI assistants.

Enables communication between multiple AI characters with simultaneous voice playback using VLC.

Remote MCP server for managing WhatsApp and Telegram AI assistants: projects, prompts, conversations, leads and analytics, with no destructive tools by design.

An MCP server integrating WhatsApp messaging and ElevenLabs AI voice capabilities into VS Code.

Multilingual intelligence + memory + safety + voice layer for autonomous AI agents

Build and publish production-ready AI agents for web, SMS, and phone directly from your coding agent via a remote MCP connection.

Interact with RetellAI's voice services to create conversational voice AI.

Enables AI assistants to initiate and manage voice calls using Twilio and OpenAI.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.