mcp-zenvia

Name: mcp-zenvia
Author: codespar

Local

github.com/codesparCommunication275Updated 4w ago

Repository

About mcp-zenvia

mcp-zenvia is an MCP server for Zenvia's multichannel messaging platform. It lets MCP clients send SMS, WhatsApp, RCS, email, voice and Facebook Messenger messages. It also covers templates, reports, webhook subscriptions and contacts.

Key features

01Covers SMS, WhatsApp, RCS, email and voice channels
02Sends pre-approved WhatsApp template messages
03Checks message delivery status by ID
04Creates and manages webhook subscriptions
05Manages contacts and the opt-out list

Use cases

01Sending WhatsApp or SMS notifications through an AI assistant
02Checking delivery status and reviewing report entries
03Managing contacts and recording opt-out requests

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "codespar-mcp-zenvia": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-zenvia"
      ],
      "env": {
        "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
      }
    }
  }
}

Run commandnpx -y @codespar/mcp-zenvia

Environment variables to set

ZENVIA_API_TOKENSecretAPI key for zenvia

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@codespar/mcp-zenvia0.2.2stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
to	string	Yes	Recipient phone number with country code (e.g. 5511999999999)
from	string	Yes	Sender ID
text	string	Yes	Message text

Details

From the project README

@codespar/mcp-zenvia

MCP server for Zenvia — multichannel messaging (SMS, WhatsApp, RCS)

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zenvia": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zenvia"],
      "env": {
        "ZENVIA_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

claude mcp add zenvia -- npx @codespar/mcp-zenvia

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "zenvia": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zenvia"],
      "env": {
        "ZENVIA_API_TOKEN": "your-token"
      }
    }
  }
}

Tools (18)

Tool	Purpose
`send_sms`	Send an SMS message
`send_whatsapp`	Send a WhatsApp message
`send_rcs`	Send an RCS (Rich Communication Services) message
`send_email`	Send a transactional email
`send_voice`	Send a voice message via TTS or pre-recorded audio URL
`send_facebook_message`	Send a Facebook Messenger message
`get_message_status`	Get message delivery status by ID
`list_channels`	List available messaging channels
`create_subscription`	Create a webhook subscription for message events
`list_subscriptions`	List all webhook subscriptions
`delete_subscription`	Delete a webhook subscription by ID
`list_contacts`	List contacts from the contact base
`create_contact`	Create a contact in the contact base
`delete_contact`	Delete a contact by ID
`send_template`	Send a WhatsApp template message (pre-approved)
`list_templates`	List approved message templates (WhatsApp/SMS/RCS)
`get_report_entries`	Get message report entries within a date range
`add_opt_out`	Add a phone number to the opt-out list (suppresses future messages)

Authentication

Zenvia uses an API token passed via the X-API-TOKEN header.

Sandbox / Testing

Zenvia provides a sandbox via the dashboard for testing messages.

Get your credentials

Go to Zenvia
Create an account
Get your API token from the dashboard
Set the ZENVIA_API_TOKEN environment variable

Environment Variables

Variable	Required	Description
`ZENVIA_API_TOKEN`	Yes	API token from Zenvia dashboard

Roadmap

v0.2 (planned)

create_contact_list — Create a contact list for campaigns
send_batch — Send batch messages to a contact list
get_report — Get message delivery reports
create_flow — Create a conversational flow
list_templates — List approved message templates

v0.3 (planned)

chatbot_integration — Integrate with Zenvia chatbot builder
analytics_dashboard — Get channel analytics and metrics

Want to contribute? Open a PR or request a tool.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.