Zoko MCP by usefulapi
Read customers, tags, agents, templates and message history; send WhatsApp messages in Zoko.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (3)
- HIGH
- MEDIUMin zoko_list_message_templates
- INFOin zoko_list_message_templates
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": {
"zoko": {
"url": "https://zoko.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://zoko.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (10)
🟢zoko_list_customers
List the customers (contacts) on this Zoko account. Zoko API: GET /v2/customer.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_get_customer(customer_id)
Get one customer's details by id. Zoko API: GET /v2/customer/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "Zoko id (from the list or get tools)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_list_customer_tags(customer_id)
List the tags on one customer. Zoko API: GET /v2/customer/{id}/tags.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "Zoko id (from the list or get tools)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_list_customer_properties(customer_id)
List the custom properties set on one customer. Zoko API: GET /v2/customer/{id}/properties.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "Zoko id (from the list or get tools)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_list_agents
List the agents (team members) on this Zoko account. Zoko API: GET /v2/agent/agents.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_list_teams
List the teams on this Zoko account. Zoko API: GET /v2/agent/teams.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_list_message_templates
List the approved WhatsApp message templates for this account, with their ids and placeholders. Use a template id with zoko_send_message. Zoko API: GET /v2/account/templates.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_get_message(message_id)
Get one sent message's details by message id. Zoko API: GET /v2/message/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"message_id": {
"type": "string",
"minLength": 1,
"description": "Zoko id (from the list or get tools)."
}
},
"required": [
"message_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zoko_get_message_history(message_id)
Get the delivery history (sent, delivered, read, failed) of one message. Zoko API: GET /v2/message/{id}/history.
Eingabe-Schema
{
"type": "object",
"properties": {
"message_id": {
"type": "string",
"minLength": 1,
"description": "Zoko id (from the list or get tools)."
}
},
"required": [
"message_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zoko_send_message(recipient, type, message, template_id, template_args)
Send a WhatsApp message to one customer through Zoko. Sends to a real person: only send with the customer's consent. Use type 'text' with `message` (only inside the 24-hour customer-service window), or type 'template' with `template_id` and optional `template_args` (for any time). Zoko API: POST /v2/message.
Eingabe-Schema
{
"type": "object",
"properties": {
"recipient": {
"type": "string",
"pattern": "^\\d{6,15}$",
"description": "Recipient phone number, digits only with country code (e.g. 919876543210)."
},
"type": {
"type": "string",
"enum": [
"text",
"template"
],
"description": "'text' for a free-form message, 'template' for an approved template."
},
"message": {
"description": "Message body (type 'text').",
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"template_id": {
"description": "Approved template id from zoko_list_message_templates (type 'template').",
"type": "string",
"minLength": 1
},
"template_args": {
"description": "Placeholder values for the template, in order (type 'template').",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"recipient",
"type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis