MCP Evolution API Supergateway

@brunonuzzi

About MCP Evolution API Supergateway

MCP Evo Supergateway is gateway application to interface with the Evolution API. It sets up an stdio MCP server defined in index.js and exposes it as a server-sent events (SSE) endpoint, making it ideal for remote connections or integration with tools like n8n.

Config

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

{
  "mcpServers": {
    "evo-mcp": {
      "command": "docker",
      "args": [
        "build",
        "--pull",
        "--rm",
        "-f",
        "Dockerfile",
        "-t",
        "mcp-evo-supergateway:latest",
        "."
      ]
    }
  }
}

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 Supergateway?

MCP Evolution API Supergateway is a gateway application that interfaces with the Evolution API. It wraps an stdio MCP server as a server-sent events (SSE) endpoint, making it suitable for remote connections and integration with tools like n8n.

How to use MCP Evolution API Supergateway?

Clone the repository, build the Docker image with docker build --pull --rm -f 'Dockerfile' -t 'mcp-evo-supergateway:latest' '.', then run the container with docker run -it --rm -p 8000:8000 mcp-evo-supergateway:latest. Set the environment variables EVOLUTION_APIKEY, EVOLUTION_INSTANCE, and EVOLUTION_API_BASE before running. Access the SSE endpoint at http://localhost:8000/sse.

Key features of MCP Evolution API Supergateway

Gateway between Evolution API and MCP clients
Exposes stdio MCP server as SSE endpoint
Ready-to-run Docker container
Configurable via environment variables
Designed for remote connections and n8n integration

Use cases of MCP Evolution API Supergateway

Remotely connect MCP clients to the Evolution API
Integrate Evolution API with n8n workflows using SSE
Run a containerized MCP gateway for automation pipelines
Test and inspect MCP requests with the inspector tool

FAQ from MCP Evolution API Supergateway

How do I access the MCP SSE server?

Once the container is running, access it at http://localhost:8000/sse.

What environment variables are required?

You must set EVOLUTION_APIKEY, EVOLUTION_INSTANCE, and EVOLUTION_API_BASE.

How do I build and run the Docker container?

Build with docker build --pull --rm -f 'Dockerfile' -t 'mcp-evo-supergateway:latest' '.' and run with docker run -it --rm -p 8000:8000 mcp-evo-supergateway:latest.

How can I test the application?

Run npx @modelcontextprotocol/inspector and connect to http://localhost:8000/sse.

Frequently asked questions

How do I access the MCP SSE server?

Once the container is running, access it at `http://localhost:8000/sse`.

What environment variables are required?

You must set `EVOLUTION_APIKEY`, `EVOLUTION_INSTANCE`, and `EVOLUTION_API_BASE`.

How do I build and run the Docker container?

Build with `docker build --pull --rm -f 'Dockerfile' -t 'mcp-evo-supergateway:latest' '.'` and run with `docker run -it --rm -p 8000:8000 mcp-evo-supergateway:latest`.

How can I test the application?

Run `npx @modelcontextprotocol/inspector` and connect to `http://localhost:8000/sse`.

Comments

Basic information

More Developer Tools MCP servers

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.