get_call
Retrieve call details
LABSCO SUMMARY
The call runs on Voyp's side; the agent holds an id and a tracking URL, not the audio.
start_call takes the number, a context saying what the call is for, and a language, then returns the call id and a progress URL — so the agent supervises a call rather than being on it, reading get_call for detail and using hangup_call to stop it. The place tools exist to close the loop around that: a search term finds candidates, a place and location give the details, and a number resolves back to a name and address.
What it is
A client for the Voyp calling API: start and end calls, follow one by id, and resolve places and numbers before dialling.
What you get
- Start a call to a number with a context describing what the call is for and a language, and get back the call id plus a URL that tracks its progress.
- Retrieve a call's details by id, and hang up a call that is running.
- Find who you are dialling: search places by term, pull one place's details in a given location, or resolve a number back to a place name and address.
- Read the account's user profile.
Requirements
A Voyp API key in VOYP_API_KEY, and a number to call.
Setup effort
One command plus a key — npx -y voyp-mcp@0.1.0, then supply credentials
USE CASES
01
Booking a table without picking up the phone
Find the restaurant and its details, start the call with the booking spelled out as context, then follow the call id until it lands.
02
Working out who a missed number belongs to
Turn the number itself into a place name and address before deciding whether it is worth returning.
03
Cutting a call short when it goes wrong
Read the call's current detail by id and end it rather than letting an unattended call run on.
7 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_user
Retrieve user profile
hangup_call
Hangup an existing call
search_place
Search place details in a given location
search_place_by_number
Find place name and address by phone number
search_places
Search places in a given location
start_call
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
BEFORE YOU INSTALL
What to know first
Tools you get
7 tools when we connected. start_call places a real phone call to a business and spends account credits. get_call, get_user, search_place, search_places and search_place_by_number have no written description.
Requires
- npx on PATH
- VOYP_API_KEY in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y voyp-mcp@0.1.0MCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"voyp-mcp": {
"command": "npx",
"args": [
"-y",
"voyp-mcp"
],
"env": {
"VOYP_API_KEY": "<YOUR_VOYP_API_KEY>"
}
}
}
}Claude Desktop — local build
CLAUDE DESKTOP — LOCAL BUILD · TERMINAL
git clone https://github.com/paulotaylor/voyp-mcp.git
cd voyp-mcp
npm install
npm run buildCLAUDE DESKTOP — LOCAL BUILD · JSON
{
"mcpServers": {
"voyp": {
"command": "node",
"args": [
"<YOUR_PATH_TO_VOYP_MCP>/build/index.js"
],
"env": {
"VOYP_API_KEY": "<YOUR_VOYP_API_KEY>"
}
}
}
}
