CallHippo MCP by usefulapi
Read users, contacts and call logs; manage contacts and Do Not Call numbers in CallHippo.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"callhippo": {
"url": "https://callhippo.usefulapi.io/mcp"
}
}
}Remote endpoints
https://callhippo.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (15)
🟢callhippo_list_users
List the users (agents) in the CallHippo account, with their email, status and team. Good first call to find a user id. CallHippo API: GET /user/list.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢callhippo_get_user(user_id)
Get one user's details by user id. CallHippo API: GET /user/details/{userid}.
Input Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"minLength": 1,
"description": "The user id (from callhippo_list_users)."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢callhippo_list_teams(page, per_page)
List the teams in the account, with pagination. CallHippo API: GET /team/list.
Input Schema
{
"type": "object",
"properties": {
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"default": 20,
"description": "Records per page.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢callhippo_list_contacts(user_id, page, per_page, updated_since)
List the contacts that belong to one user, with pagination. Optionally only those updated since a date. CallHippo API: GET /contact/{userId}.
Input Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"minLength": 1,
"description": "The owner's user id (from callhippo_list_users)."
},
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"default": 20,
"description": "Records per page.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"updated_since": {
"description": "Only contacts updated on or after this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴callhippo_add_contact(number, first_name, last_name, email)
Create a contact with a phone number, first name, last name and email. Writes to the account; it creates a new record each time it runs. CallHippo API: POST /contact/add.
Input Schema
{
"type": "object",
"properties": {
"number": {
"type": "string",
"minLength": 1,
"description": "Phone number in international format, for example +14155550100."
},
"first_name": {
"type": "string",
"minLength": 1
},
"last_name": {
"type": "string",
"minLength": 1
},
"email": {
"type": "string",
"minLength": 1,
"description": "Contact email address."
}
},
"required": [
"number",
"first_name",
"last_name",
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴callhippo_update_contact(contact_id, number, first_name, last_name, email)
Replace a contact's phone number, first name, last name and email. Send all four values, the current ones included. CallHippo API: PUT /contact/edit/{contactId}.
Input Schema
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"minLength": 1,
"description": "The contact id (from callhippo_list_contacts)."
},
"number": {
"type": "string",
"minLength": 1,
"description": "Phone number in international format."
},
"first_name": {
"type": "string",
"minLength": 1
},
"last_name": {
"type": "string",
"minLength": 1
},
"email": {
"type": "string",
"minLength": 1
}
},
"required": [
"contact_id",
"number",
"first_name",
"last_name",
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴callhippo_delete_contact(contact_id, confirm)
DELETES a contact from CallHippo. Permanent for the contact record. Call only when the user asked to delete this exact contact; confirm must be true. CallHippo API: DELETE /contact/{contactId}.
Input Schema
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"minLength": 1,
"description": "The contact id to delete."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true. Set it only after the user asked for this exact action in this conversation."
}
},
"required": [
"contact_id",
"confirm"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴callhippo_add_dnc_number(number, dnc_type)
Add a phone number to the account's Do Not Call list, for incoming calls, outgoing calls, or both. Adding a number blocks calls to or from it. CallHippo API: POST /dnc/addnumber.
Input Schema
{
"type": "object",
"properties": {
"number": {
"type": "string",
"minLength": 1,
"description": "Phone number in international format."
},
"dnc_type": {
"type": "string",
"enum": [
"both",
"incoming",
"outgoing"
],
"description": "Which calls to block."
}
},
"required": [
"number",
"dnc_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴callhippo_remove_dnc_number(number, confirm)
Remove a phone number from the Do Not Call list, so calls to and from it are allowed again. Removing a number can break a customer's opt-out. Call only when the user asked for this exact number; confirm must be true. CallHippo API: POST /dnc/deletenumber.
Input Schema
{
"type": "object",
"properties": {
"number": {
"type": "string",
"minLength": 1,
"description": "Phone number in international format."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true. Set it only after the user asked for this exact action in this conversation."
}
},
"required": [
"number",
"confirm"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢callhippo_list_call_logs(start_date, end_date, skip, limit, crm_unique_id, ...)
List call logs (the activity feed) for a date range, with an offset (skip) and a page size (limit). Optionally filter by CRM record id or call SID. Read only. CallHippo API: POST /activityfeed (the vendor takes this read as POST).
Input Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}\\/\\d{2}\\/\\d{2}$",
"description": "Date as yyyy/mm/dd."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}\\/\\d{2}\\/\\d{2}$",
"description": "Date as yyyy/mm/dd."
},
"skip": {
"default": 0,
"description": "Number of records to skip (offset).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"default": 20,
"description": "Records to return.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"crm_unique_id": {
"description": "Only logs linked to this CRM record id.",
"type": "string"
},
"call_sid": {
"description": "Only the log of this call SID.",
"type": "string"
}
},
"required": [
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢callhippo_list_sms_logs(start_date, end_date, skip, limit, sms_id, ...)
List SMS logs for a date range, with an offset (skip) and a page size (limit). Optionally filter by SMS id, sender or recipient. Read only. CallHippo API: POST /sms/logs (the vendor takes this read as POST).
Input Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}\\/\\d{2}\\/\\d{2}$",
"description": "Date as yyyy/mm/dd."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}\\/\\d{2}\\/\\d{2}$",
"description": "Date as yyyy/mm/dd."
},
"skip": {
"default": 0,
"description": "Number of records to skip (offset).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"default": 20,
"description": "Records to return.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"sms_id": {
"description": "Only the SMS with this id.",
"type": "string"
},
"from": {
"description": "Only messages sent from this number.",
"type": "string"
},
"to": {
"description": "Only messages sent to this number.",
"type": "string"
}
},
"required": [
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴callhippo_make_call(to_number, from_number, agent_id, integration_name, object_type, ...)
PLACES A REAL PHONE CALL from an agent's number to a phone number, and can link the call to a CRM record. Costs money and rings a real phone. Call only when the user asked for this exact call; confirm must be true. CallHippo API: POST /call.
Input Schema
{
"type": "object",
"properties": {
"to_number": {
"type": "string",
"minLength": 1,
"description": "Number to call, in international format."
},
"from_number": {
"type": "string",
"minLength": 1,
"description": "CallHippo number to call from (must belong to the agent)."
},
"agent_id": {
"type": "string",
"minLength": 1,
"description": "The agent (user) id who places the call."
},
"integration_name": {
"description": "CRM name to sync the call to, for example salesforce.",
"type": "string"
},
"object_type": {
"description": "CRM module, for example contact or lead.",
"type": "string"
},
"object_id": {
"description": "CRM record id in that module.",
"type": "string"
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true. Set it only after the user asked for this exact action in this conversation."
}
},
"required": [
"to_number",
"from_number",
"agent_id",
"confirm"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢callhippo_list_campaigns(campaign_type, page, per_page)
List power-dialer campaigns, with pagination and an optional campaign type filter. CallHippo API: GET /campaign/list.
Input Schema
{
"type": "object",
"properties": {
"campaign_type": {
"description": "Optional campaign type filter. The spec does not list the values.",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"default": 20,
"description": "Records per page.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢callhippo_get_campaign(campaign_id)
Get one power-dialer campaign by id, including its settings. CallHippo API: GET /campaign/{campaignId}.
Input Schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"description": "The campaign id (from callhippo_list_campaigns)."
}
},
"required": [
"campaign_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴callhippo_set_campaign_status(campaign_id, action, confirm)
START or STOP a power-dialer campaign. A started campaign places real calls to its contacts. Call only when the user asked for this exact change; confirm must be true. CallHippo API: PATCH /campaign/{campaignId}/{action}.
Input Schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"description": "The campaign id (from callhippo_list_campaigns)."
},
"action": {
"type": "string",
"enum": [
"start",
"stop"
],
"description": "start or stop."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true. Set it only after the user asked for this exact action in this conversation."
}
},
"required": [
"campaign_id",
"action",
"confirm"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence