MCP.so
Sign In

MCP Evolution API

@genera-ai

Repository

About MCP Evolution API

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

Basic information

Category

Developer Tools

Runtime

node

Transports

stdio

Publisher

genera-ai

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.

Comments

More Developer Tools MCP servers

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K

Smithery CLI

smithery-ai

Install, manage and develop MCP servers and skills for agents

788

MCP Containers

metorial

Connect any AI model to 1200+ integrations (MCP, CLI, API)

3.3K

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K