Bring Whatsapp Api
to Pydantic AI
Learn how to connect Zenvia Conversion to Pydantic AI and start using 10 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
What is the Zenvia Conversion MCP Server?
Connect your Zenvia Conversion (formerly Sirena) account to any AI agent to automate your sales and support workflows. Manage leads, send WhatsApp messages, and track interactions through natural conversation.
What you can do
- Lead Management — Create and manage leads from multiple sources and track their conversion into prospects.
- WhatsApp Messaging — Send free-text messages to active conversations or initiate new ones using HSM templates.
- Team Coordination — List agents, groups, and labels to maintain a clear overview of your team's structure and assignments.
- Interaction History — View full interaction logs and histories for any prospect to maintain context across your sales pipeline.
- Workflow Automation — Streamline repetitive tasks like lead creation and follow-ups using natural language commands.
How it works
1. Subscribe to this server
2. Enter your Zenvia Conversion API Key (from API Access app)
3. Start managing your sales conversations from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Sales Teams — manage leads and WhatsApp conversations more efficiently without switching apps.
- Support Agents — quickly respond to customer queries and track interaction history.
- Marketing Managers — monitor lead acquisition and conversion rates across different groups and agents.
Built-in capabilities (10)
You can include contact details and an initial message (comment). Create a new lead in Zenvia Conversion
Get account information
Get detailed information about a specific prospect
List agents in the account
List agent groups
List interactions for a prospect
List labels
List all prospects in Zenvia Conversion
Send a message to a prospect
Send a message template (HSM) to a prospect
Why Pydantic AI?
Pydantic AI validates every Zenvia Conversion tool response against typed schemas, catching data inconsistencies at build time. Connect 10 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
- —
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
- —
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Zenvia Conversion integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your Zenvia Conversion connection logic from agent behavior for testable, maintainable code
Zenvia Conversion in Pydantic AI
Zenvia Conversion and 3,400+ other MCP servers. One platform. One governance layer.
Teams that connect Zenvia Conversion to Pydantic AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 3,400+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Zenvia Conversion in Pydantic AI
The Zenvia Conversion MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 10 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Pydantic AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
Zenvia Conversion for Pydantic AI
Every tool call from Pydantic AI to the Zenvia Conversion MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
What is the difference between a Lead and a Prospect?
In Zenvia Conversion, a Lead is an initial contact entry. Once a lead is processed or created via the API, it becomes a Prospect in your CRM pipeline.
Can I start a WhatsApp conversation with a new number?
Yes, but you must use an approved HSM template to initiate a new conversation. Free-text messages can only be sent to active conversations within the 24-hour window.
How does Pydantic AI discover MCP tools?
Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
Does Pydantic AI validate MCP tool responses?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your Zenvia Conversion MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai