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:
- 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 [email protected]
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 does not 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%Claudeclaude_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
-
Clone the repository:
git clone https://github.com/paulotaylor/voyp-mcp.git
cd voyp-mcp
-
Install dependencies:
npm install
-
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
- 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
-
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.
-
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 ✨
[
{
"description": "Start a new phone call via Voyp API. The API returns the call id and a URL where users can track the progress of the call",
"inputSchema": {
"properties": {
"context": {
"description": "Context of the call. Ex: Order a pizza",
"type": "string"
},
"language": {
"description": "Language of the call. Ex: en-US, pt-PT, fr-FR",
"type": "string"
},
"number": {
"description": "Phone number to call in E.164 format",
"type": "string"
}
},
"required": [
"number",
"context"
],
"type": "object"
},
"name": "start_call"
},
{
"description": "Hangup an existing call",
"inputSchema": {
"properties": {
"id": {
"description": "ID of the call",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "hangup_call"
},
{
"description": "Search places in a given location",
"inputSchema": {
"properties": {
"search": {
"description": "Places to search. Ex: italian restaurants in New York City, US",
"type": "string"
}
},
"required": [
"search"
],
"type": "object"
},
"name": "search_places"
},
{
"description": "Search place details in a given location",
"inputSchema": {
"properties": {
"location": {
"description": "Place location. Ex: San Francisco, CA",
"type": "string"
},
"place": {
"description": "Name of place to search. Ex: The Lane Salon",
"type": "string"
}
},
"required": [
"place",
"location"
],
"type": "object"
},
"name": "search_place"
},
{
"description": "Find place name and address by phone number",
"inputSchema": {
"properties": {
"number": {
"description": "Phone number in E.164 format. Ex: +1234567890",
"type": "string"
}
},
"required": [
"number"
],
"type": "object"
},
"name": "search_place_by_number"
},
{
"description": "Retrieve call details",
"inputSchema": {
"properties": {
"id": {
"description": "Call Id",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_call"
},
{
"description": "Retrieve user profile",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_user"
}
]