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

A
Description quality
100%
Schema completeness
93%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,870Tokens (tool definitions)
~1.3 KBTypical response size
Significant attention impact (2.24% of 128k context)

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-http

What it can do

Tool inventory

Tools (15)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded15 tools