How to Use the Zenvia Conversion MCP in Claude Code

Q: How do I search for Zenvia Conversion leads using Claude Code?

You execute listprospects directly in the terminal. The output is piped as raw data, allowing you to feed it straight into a filtering script or database loader.

Q: Can I check old conversations in Zenvia Conversion using Claude Code?

Yes. listinteractions pulls the full activity log for scripting purposes. You can process these logs to count messages or find specific dates for compliance checks.

Q: Does Zenvia Conversion support group management with Claude Code?

You interact with listgroups and listlabels. This lets your backend service programmatically manage the tagging and categorization of large volumes of records in Zenvia Conversion.

Q: How do I verify my accounts in Zenvia Conversion with Claude Code?

Run getaccount. This command pulls the necessary scope data needed to authenticate your script against the Zenvia Conversion endpoint. It's a critical first step for any CI/CD job.

Automate Zenvia Conversion messaging via Claude Code for headless CI/CD pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zenvia Conversion MCP to Claude Code

Create your Vinkius account to connect Zenvia Conversion to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Zenvia Conversion with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage leads and messages through the MCP Server.

From a script or container, you can execute `create_lead`. Pass it contact details and an initial comment, and the lead is created in Zenvia Conversion. This works perfectly for nightly batch jobs. It’s reliable automation: your shell script calls the endpoint, gets confirmation, and moves on.

Retrieve detailed prospect data from Zenvia Conversion.

Need a single record? Use `get_prospect`. Pipe this output into a subsequent tool or save it as JSON. This gives your CI/CD pipeline granular access to specific lead information. It's far more reliable than scraping a UI; you get clean, structured data every time.

Automate outreach messaging with Zenvia Conversion.

Use `send_message` or `send_template`. You send the message payload and the target ID via standard input. The output confirms the transmission status, which is key for auditing. This ensures that your scheduled tasks actually complete their communication goals.

Setup guide

Set up Zenvia Conversion MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see zenvia-conversion-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Zenvia Conversion transactions." It will automatically discover and invoke the available Zenvia Conversion tools.

Terminal

claude mcp add --transport http zenvia-conversion-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Zenvia Conversion MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "zenvia-conversion-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Zenvia Conversion. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Zenvia Conversion now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Zenvia Conversion MCP in Claude Code

You execute `list_prospects` directly in the terminal. The output is piped as raw data, allowing you to feed it straight into a filtering script or database loader.

Yes. `list_interactions` pulls the full activity log for scripting purposes. You can process these logs to count messages or find specific dates for compliance checks.

You interact with `list_groups` and `list_labels`. This lets your backend service programmatically manage the tagging and categorization of large volumes of records in Zenvia Conversion.

This server handles contact details, message templates, group structures, and overall account metadata for Zenvia Conversion.

Run `get_account`. This command pulls the necessary scope data needed to authenticate your script against the Zenvia Conversion endpoint. It's a critical first step for any CI/CD job.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript