Skip to main content
Glama

Zappaz MCP Server

O Zappaz MCP Server conecta ferramentas MCP a Zappaz API de WhatsApp. Ele expoe tools para envio e gerenciamento de mensagens (texto, imagem, video, audio, documento, contato, localizacao) usando um sessionId e um token de sessao.

Casos de uso

  • Envio de mensagens via WhatsApp a partir de agentes MCP.

  • Automacao de atendimentos com multimidia (imagem, video, audio, documento).

  • Compartilhamento de contatos e localizacoes.

  • Remocao de mensagens pelo id.


Servidor Zappaz MCP (Remoto)

O servidor e remoto e esta disponivel em https://mcp.zappaz.io.


Related MCP server: MCP WhatsApp

Autenticacao

Todas as chamadas exigem:

  • sessionId no query string (?sessionId=...)

  • Authorization no header

Sem esses valores o servidor retorna erro.


Configuracao no OpenCode

Adicione o servidor no seu opencode.json do OpenCode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Cursor

Crie o arquivo .cursor/mcp.json com a entrada abaixo:

{
  "mcpServers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Antigravity

No Agent Panel, clique nos tres pontos no canto superior direito e selecione MCP Servers. Clique em Manage MCP Servers. Selecione "View raw config" e adicione:

{
  "mcpServers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "serverUrl": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no VS Code

Abra a Command Palette (Cmd+Shift+P) e digite "MCP: Add Server". Selecione "Add MCP Server". Escolha HTTP para adicionar um MCP remoto. Informe a URL https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION e o nome zappaz-mcp.

Depois, edite o mcp.json para adicionar o header de autorizacao:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Claude Desktop

Adicione o servidor no seu arquivo de configuracao MCP:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Claude Code

Adicione o servidor no seu arquivo de configuracao MCP:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Windsurf

Adicione o servidor no seu arquivo de configuracao MCP:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Tools disponiveis

Tool de Mensagens

Tool

Descricao

send_text_message

Envia mensagem de texto.

send_image_message

Envia mensagem de imagem.

send_video_message

Envia mensagem de video.

send_audio_message

Envia mensagem de audio.

send_document_message

Envia mensagem de documento.

send_contact_message

Envia mensagem com contato.

send_location_message

Envia mensagem com localizacao.

delete_message

Deleta uma mensagem por id.

Tool de Grupos

Tool

Descricao

list_groups

Lista todos os grupos da sessao.

get_group_participants

Lista os participantes de um grupo.

create_group

Cria um novo grupo.

add_participants

Adiciona participantes a um grupo.

remove_participants

Remove participantes de um grupo.

promote_participants

Promove participantes a administradores.

demote_participants

Rebaixa administradores a membros.

send_group_invite_link

Envia o link de convite de um grupo.

update_group

Atualiza nome, descricao e configuracoes do grupo.

update_group_picture

Atualiza a foto do grupo.

Tool de Webhooks

Tool

Descricao

get_webhooks

Obtem a lista de webhooks configurados para uma sessao.

create_webhook

Cria um novo webhook para uma sessao.

update_webhook

Atualiza um webhook existente para uma sessao.

delete_webhook

Deleta um webhook existente para uma sessao.


Observacoes

  • O token e o sessionId sao obrigatorios para todas as chamadas.

Available Tools

22 tools
add_participantsC

Adiciona participantes a um grupo na Zappaz API

Inputs: data (required), groupId (required).

create_groupC

Cria um novo grupo na Zappaz API

Inputs: data (required).

create_webhookC

Cria um novo webhook para uma sessão na Zappaz API

Inputs: data (required).

delete_messageC

Deleta uma mensagem atraves da Zappaz API

Inputs: messageId (required).

delete_webhookC

Deleta um webhook existente para uma sessão na Zappaz API

Inputs: webhookId (required).

demote_participantsC

Rebaixa participantes de administradores a membros de um grupo na Zappaz API

Inputs: data (required), groupId (required).

get_group_participantsC

Obtém a lista de participantes de um grupo específico na Zappaz API

Inputs: groupId (required).

get_webhooksB

Obtém a lista de webhooks configurados para uma sessão na Zappaz API

Inputs: no named parameters.

list_groupsB

Lista todos os grupos de uma sessão na Zappaz API

Inputs: no named parameters.

promote_participantsC

Promove participantes a administradores de um grupo na Zappaz API

Inputs: data (required), groupId (required).

remove_participantsC

Remove participantes de um grupo na Zappaz API

Inputs: data (required), groupId (required).

send_audio_messageC

Envia uma mensagem de áudio atraves da Zappaz API

Inputs: data (required).

send_contact_messageC

Envia uma mensagem com um contato atraves da Zappaz API

Inputs: data (required).

send_document_messageC

Envia uma mensagem de documento atraves da Zappaz API

Inputs: data (required).

send_image_messageC

Envia uma mensagem de imagem atraves da Zappaz API

Inputs: data (required).

send_location_messageC

Envia uma mensagem com uma localização por endereço ou coordenadas atraves da Zappaz API

Inputs: data (required).

send_text_messageC

Envia uma mensagem de texto atraves da Zappaz API

Inputs: data (required).

send_video_messageC

Envia uma mensagem de vídeo atraves da Zappaz API

Inputs: data (required).

update_groupC

Atualiza as informações de um grupo específico na Zappaz API

Inputs: data (required), groupId (required).

update_group_pictureC

Atualiza a foto de um grupo específico na Zappaz API

Inputs: data (required).

update_webhookC

Atualiza um webhook existente para uma sessão na Zappaz API

Inputs: data (required), webhookId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 22 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: webhook CRUD, message sending by type, and group management operations. Overlaps like update_group vs. update_group_picture are clearly differentiated by their descriptions. An agent can reliably select the intended tool.

    Naming Consistency5/5

    All tools use a consistent snake_case verb_noun pattern in Portuguese/English mixed terms, e.g., send_text_message, create_webhook, add_participants. Pluralization varies slightly but follows natural resource semantics and remains predictable.

    Tool Count3/5

    With 22 tools, the set is borderline heavy for the scope. While most map to distinct API operations, several message send variants and group participant actions could potentially be consolidated. It is still navigable but sits in the heavy range.

    Completeness3/5

    Webhook lifecycle is complete, but message handling lacks retrieval/list operations (e.g., get messages, mark as read) and group management lacks delete/get group details or leave group. These omissions are notable for an agent relying on full CRUD workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables WhatsApp automation through MCP protocol, allowing users to manage sessions, send messages, handle groups/communities, and access contacts through natural language interactions with AI agents.
      5 npm
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that turns WhatsApp into agent-callable tools, enabling search contacts, send/receive messages, read chats, handle media, and monitor calls via the WhatsApp Web multi-device protocol.
      9 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables connecting a personal WhatsApp number to any MCP client, providing tools to send, search, and manage WhatsApp messages, with an optional auto-reply feature.
      23 PyPI
      5
      MIT