CallHippo MCP by usefulapi
Read users, contacts and call logs; manage contacts and Do Not Call numbers in CallHippo.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"callhippo": {
"url": "https://callhippo.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://callhippo.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
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.
Eingabe-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}.
Eingabe-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.
Eingabe-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}.
Eingabe-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.
Eingabe-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}.
Eingabe-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}.
Eingabe-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.
Eingabe-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.
Eingabe-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).
Eingabe-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).
Eingabe-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.
Eingabe-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.
Eingabe-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}.
Eingabe-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}.
Eingabe-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
Nachweis