MCP Evolution API

@genera-ai

About MCP Evolution API

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

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",
        "\\"
      ]
    }
  }
}

Tools

No tools detected

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

FAQ from MCP Evolution API

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.

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

Basic information

More Developer Tools MCP servers

Altronis

sypherin

MCP server + CLI for Altronis — Singapore AI consulting. Ask the Lyra consultant, generate a grant-matched AI transformation plan, pull curated SG AI events/news. Read-only, wraps altronis.sg.

Grafana MCP server

grafana

MCP server for Grafana

3.2K

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K