Integration

Evolution API integration

Evolution API v2, the self-hosted WhatsApp gateway. Manage instances (create, connect through a QR code or pairing code, read connection state, log out, delete), send messages (text, media, location), check whether phone numbers are on WhatsApp, mark messages as read, query the stored chats, contacts and messages of an instance, create groups and manage their participants, and configure the webhook that pushes incoming events. Every call is scoped to a named instance, and the server is your own, so the host is part of the credential.

Connect Evolution API How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Evolution API.Built from the 19 Evolution API tools below, on the connection you add once.

Common Evolution API use cases

sending a delivery address to a driver
delivering an invoice PDF over WhatsApp
moving an instance to a different phone number
decommissioning a sender that is no longer used
adding a colleague to an existing customer group
guarding a send step behind a connectivity check
notifying a customer on WhatsApp from a workflow
listing recent conversations to pick one to answer
re-pairing an instance whose session was logged out
discovering the instance name before sending a message

What you can do with Evolution API

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Instance, 6 operations

connect_instanceConnect instanceGETIssues a fresh pairing QR code for an instance that is not linked yet.
create_instanceCreate instancePOSTCreates a named WhatsApp instance and returns the QR code needed to pair a phone.
delete_instanceDelete instanceDELETEPermanently removes an instance from the server.
get_connection_stateGet connection stateGETReports whether an instance is open, connecting or closed.
list_instancesList instancesGETLists every instance on the server with its connection status.
logout_instanceLogout instanceDELETELogs the phone out of an instance while keeping the instance itself.

Message, 5 operations

find_messagesFind messagesPOSTQueries the instance's stored messages, newest first, in pages.
mark_message_as_readMark message as readPOSTMarks specific messages as read on the linked phone.
send_locationSend locationPOSTSends a map pin with optional place name and address.
send_mediaSend mediaPOSTSends a media message built from a public URL or base64 payload.
send_textSend textPOSTSends a text message from an instance to a number or a group.

Group, 3 operations

create_groupCreate groupPOSTCreates a group and adds the given participants.
get_group_participantsGet group participantsGETLists a group's participants and which of them are administrators.
update_group_participantUpdate group participantPOSTAdds, removes, promotes or demotes participants of a group in one call.

Webhook, 2 operations

get_webhookGet webhookGETReads back an instance's webhook URL, enabled flag and event list.
set_webhookSet webhookPOSTPoints an instance's events at a webhook URL and selects which events are sent.

Chat, 1 operation

find_chatsFind chatsPOSTQueries the instance's stored chats with a filter, a limit and an offset.

Contact, 1 operation

find_contactsFind contactsPOSTQueries the instance's stored contacts with a filter and page controls.

Number, 1 operation

check_whatsapp_numbersCheck whatsapp numbersPOSTTells you which of a list of phone numbers actually have WhatsApp.

Use Evolution API from Claude Code, Cursor or Codex

Connect Evolution API in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Evolution API operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Evolution API

Create your workspace
Sign up free. Nothing to install.
Connect Evolution API once
Add your Evolution API connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Evolution API integration FAQ

What can you do with the Evolution API integration?

LiveContext exposes 19 operations on Evolution API, covering instance, message, group and webhook. Common uses include sending a delivery address to a driver, delivering an invoice PDF over WhatsApp and moving an instance to a different phone number.