Voyp

What is Voyp MCP Server?

The Voyp Model Context Protocol (MCP) server is an open-standard solution that allows Artificial Intelligence systems, such as Anthropic's Claude, to seamlessly interact with real-world communication channels, specifically phone calls. It extends AI capabilities by enabling them to initiate, monitor, and manage phone calls, bridging the gap between AI models and practical communication tasks.

How to use Voyp MCP Server?

To use the Voyp MCP server, you need a Voyp API key (with credits), a compatible AI client like Claude Desktop or Goose, and Node.js (v20 or higher). Installation can be done via Smithery, NPX, or by cloning the Git repository. After installation, you need to configure your AI client (e.g., Claude Desktop) by adding the Voyp MCP server configuration, including your Voyp API key. Once configured, restart your AI client to enable the new functionalities.

Key Features of Voyp MCP Server

• Robust Call Context Construction: Enables the creation of detailed call contexts for effective communication.
• Business Information Search: Allows AI to search for business information (e.g., restaurants, dentists) during calls.
• Appointment and Reservation Management: Facilitates making appointments, reservations, consultations, and inquiries via calls.
• Call Status Provision: Provides real-time updates on the status of ongoing calls.
• Call Termination: Enables AI to hang up calls when necessary.
• Seamless AI Integration: Designed for smooth integration with AI assistants like Claude.

Use Cases of Voyp MCP Server

• Automated Customer Service: AI agents can make outbound calls to customers for follow-ups, support, or information gathering.
• Appointment Scheduling: AI can call businesses to schedule or confirm appointments for users.
• Information Gathering: AI can call various establishments to gather specific information, such as opening hours or service details.
• Lead Generation and Qualification: AI can make calls to qualify leads or conduct preliminary interviews.
• Personal Assistant: AI can act as a personal assistant, handling various calling tasks on behalf of the user.

FAQ from Voyp MCP Server

Q: What are the prerequisites for using Voyp? A: You need a Voyp API key (with credits), Claude Desktop or Goose, Node.js (v20 or higher), and Git (if using Git installation).

Q: How do I install Voyp MCP server? A: You can install it via Smithery, NPX, or by cloning the Git repository and running npm install and npm run build.

Q: How do I configure Claude Desktop with Voyp MCP server? A: You need to create or modify the claude_desktop_config.json file in your Claude application support directory and add the Voyp MCP server configuration with your API key.

Q: What should I do if I encounter "Server Not Found" issues? A: Verify npm and Node.js installations, check Claude Desktop configuration syntax, and ensure Node.js is properly installed.

Q: How do I resolve NPX related issues? A: You might need to use the full path to the npx executable in your configuration, which can be found by running which npx.

Q: What if I have API Key Issues? A: Confirm your Voyp API key is valid, correctly set in the config, and free of extra spaces or quotes.

Voyp Model Context Protocol server

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.

The Voyp MCP server allows you to:

• 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

Prerequisites 🔧

Before you use Voyp, you need:

• Voyp API key
  • You will also need to buy credits to spend while making calls. You can also buy credits here
• Claude Desktop, Goose or other compatible clients
• Node.js (v20 or higher)
  • You can verify your Node.js installation by running:
    • node --version
• Git installed (only needed if using Git installation method)
  • On macOS: brew install git
  • On Linux:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • On Windows: Download Git for Windows

Voyp MCP server installation for Goose ⚡

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

Voyp + Goose Demo:

Voyp MCP server installation for Claude Desktop ⚡

To install the voyp-mcp server, you can use the following methods:

1. Installing via Smithery
2. Running with NPX
3. Git installation

1. Installing via Smithery

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

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

2. Running with NPX

npx -y voyp-mcp@0.1.0   

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.

Configuring the Claude Desktop app ⚙️

For macOS:

# 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"

For Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add the Voyp server configuration:

Replace your-VOYP-api-key with your actual VOYP API key.

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

3. Git Installation

1. Clone the repository:

git clone https://github.com/paulotaylor/voyp-mcp.git
cd voyp-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuring the Claude Desktop app ⚙️

Follow the configuration steps outlined in the Configuring the Claude Desktop app section above, using the below JSON configuration.

Replace your-VOYP-api-key-here with your actual VOYP API key and /path/to/voyp-mcp with 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"
      }
    }
  }
}

Usage in Claude Desktop App 🎯

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.

Voyp + Claude Desktop Demo:

Troubleshooting 🛠️

Common Issues

1. Server Not Found

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

2. NPX related issues

• If you encounter errors related to npx, you may need to use the full path to the npx executable instead.
• You can find this path by running which npx in your terminal, then replace the "command": "npx" line with "command": "/full/path/to/npx" in your configuration.

3. 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

Acknowledgments ✨

• Model Context Protocol for the MCP specification
• Anthropic for Claude Desktop