Z API MCP Server

Z-API uses instance ID and token embedded in the request URL. Z-API offers a free trial for testing. Create an account to get started. Its 27 documented tools cover group, contacts, button, metadata.

People connecting communication tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Z API

before you install - you'll need

Set ZAPI_INSTANCE_ID, ZAPI_TOKEN before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-communic -- npx -y @codespar/mcp-z-api

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-communic": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-z-api"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-z-api - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Z API can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can send a text message via WhatsApp, send an image message via WhatsApp, send a document via WhatsApp, and send an audio message via WhatsApp.

Capability map

Tools grouped from the project's README - what Z API lets an agent do.

run & execute

6 tools - e.g. Send a text message via WhatsApp; Send an image message via WhatsApp; Send a document via WhatsApp

send_text · send_image · send_document · send_audio · send_location · send_option_list

read & search

6 tools - e.g. Get profile picture URL for a phone number; Get messages for a phone number; Get WhatsApp instance connection status

get_profile_picture · get_messages · get_status · get_labels · list_chats · list_groups

Group

4 tools - e.g. Create a WhatsApp group; Get group metadata and participants; Add a participant to a WhatsApp group

create_group · get_group_metadata · add_group_participant · remove_group_participant

Contacts

2 tools - e.g. Get all WhatsApp contacts; Add one or more contacts to the WhatsApp address book.

get_contacts · add_contacts

Button

2 tools - e.g. Send a button list message via WhatsApp; Send interactive action buttons (CALL, URL, REPLY).

send_button_list · send_button_actions

Contact

2 tools - e.g. Send a contact card via WhatsApp; Get metadata (name, WhatsApp display name, profile picture, status) for a single contact

send_contact · get_contact_metadata

Message

2 tools - e.g. Mark messages as read; Delete a message

read_message · delete_message

Check

1 tool - e.g. Check if a phone number has WhatsApp

check_number

04 · Who maintains Z API

mcp-z-api is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: communication - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-z-api (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-z-api

06 · Z API FAQ

Is Z API still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Z API do?

With this server connected, an agent can send a text message via WhatsApp, send an image message via WhatsApp, send a document via WhatsApp, and send an audio message via WhatsApp.

How do I install Z API?

Run `npx -y @codespar/mcp-z-api`. The README documents 2 environment variables (ZAPI_INSTANCE_ID, ZAPI_TOKEN) to set first. Set ZAPI_INSTANCE_ID, ZAPI_TOKEN before connecting. You can also paste the ready-made client config above.

Does Z API run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Z API

Alternatives to Z API

Maintained communication servers if Z API isn't the fit.

Pairs well with

Servers that cover what Z API doesn't - only shown when the pairing reason fits the companion.

More communication MCP servers · Zenvia · Orca Router · Pusher Channels · Imessage Max · Cobroya

More JavaScript MCP servers · Bitso · Circle · Coinbase Cdp · Coinbase Commerce · see all