Skip to main content
Z-

Z-API

v0.2.0API Key

WhatsApp Business API: messages, media, templates, and delivery webhooks. Your agent sends receipts, confirmations, and support responses.

27 tools1 env vars๐Ÿ‡ง๐Ÿ‡ท Brazilstable on npm

Install

terminal
$ npm install @codespar/mcp-z-api

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "z-api": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-z-api"
      ],
      "env": {
        "ZAPI_TOKEN": "<your_zapi_token>"
      }
    }
  }
}

After restart, your agent can call any of the 27 tools below โ€” try send_text first.

Environment variables ยท 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

ZAPI_TOKEN
requiredsecret

API key for z-api

Available tools ยท 27

Each tool is independent โ€” your agent loads only what it needs to reduce context and response time.

WRITEsend_text
Send a text message via WhatsApp
WRITEsend_image
Send an image message via WhatsApp
WRITEsend_document
Send a document via WhatsApp
WRITEsend_audio
Send an audio message via WhatsApp
READget_contacts
Get all WhatsApp contacts
READcheck_number
Check if a phone number has WhatsApp
READget_profile_picture
Get profile picture URL for a phone number
READget_messages
Get messages for a phone number

Compatible frameworks

MCP is a protocol โ€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets โ€” it receives scoped, short-lived session tokens.
Servers โ€” Every LatAm commerce API your agent needs | CodeSpar