MCP Evolution API

@genera-ai

Basic information

About MCP Evolution API

MCP server for evolution api, the non official api for whatsapp

MCP Evolution API config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-evolution-api": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "-p",
        "3000:3000",
        "\\"
      ]
    }
  }
}

MCP Evolution API tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Evolution API?

MCP Evolution API is a Model Context Protocol server that integrates with Evolution API for WhatsApp. It enables language models to manage WhatsApp instances, send text messages, obtain QR codes for connection, and check instance status.

How to use MCP Evolution API?

Configure environment variables (EVOLUTION_API_URL, EVOLUTION_API_KEY, PORT, API_KEY) in a .env file. Run locally with npm run dev or in production with npm run build then npm start. Deploy via Docker using docker run -d -p 3000:3000 ... or Docker Compose. Use the exposed tools through HTTP endpoints authenticated with a X-API-Key header.

Key features of MCP Evolution API

Create new WhatsApp instances via Evolution API
List all available WhatsApp instances
Retrieve QR code for instance connection
Send text messages to WhatsApp contacts
All endpoints protected by API key authentication

Use cases of MCP Evolution API

Automate WhatsApp messaging from an AI assistant
Manage multiple WhatsApp instances programmatically
Connect new WhatsApp devices by obtaining QR codes
Monitor and check instance connection status

Frequently asked questions

What are the requirements to run MCP Evolution API?

Node.js 18 or higher and NPM or Yarn are required. You also need access to an Evolution API installation (URL and API key).

How do I authenticate requests to MCP Evolution API?

Add an `X-API-Key` header with the key defined in the `API_KEY` environment variable. All routes except `/initialize` require this authentication.

What tools are available in MCP Evolution API?

The server exposes four tools: `createEvolutionInstance`, `listEvolutionInstances`, `getWhatsAppQrCode`, and `sendWhatsAppMessage`.

How can I deploy MCP Evolution API with Docker?

Run `docker run -d -p 3000:3000 -e EVOLUTION_API_URL=... -e EVOLUTION_API_KEY=... -e API_KEY=... --name mcp-evolution-api generaai/mcp-evolution-api:latest`. You can also use an `.env.docker` file with `--env-file` or Docker Compose.

Where does my WhatsApp data live when using MCP Evolution API?

The README does not specify data storage details. The server interfaces with the Evolution API, so data likely resides on the Evolution API server you connect to.

Comments

More Developer Tools MCP servers

Final POS – Custom POS Builder

Final Commerce

Build custom POS apps with your AI agent. Final's MCP server lets developers scaffold checkout flows, adapt vetted screen blueprints for counter POS, self-checkout kiosks, restaurant ordering and payment terminals, previ

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C