# Kapso Agent Instructions

Kapso is the WhatsApp API for developers.

## Use the right surface

- For live WhatsApp operations, use Kapso WhatsApp MCP: `https://api.kapso.ai/mcp`.
- For terminal access, use the Kapso CLI.
- For codebase edits, install Kapso agent skills.

## Install

```bash
curl -fsSL https://kapso.ai/install.sh | bash
kapso setup
```

## Kapso WhatsApp MCP

```bash
export KAPSO_API_KEY="your_project_api_key"
codex mcp add kapso --url https://api.kapso.ai/mcp --bearer-token-env-var KAPSO_API_KEY
```

## Safety

- Never print API keys, access tokens, webhook secrets, or customer credentials.
- Never send WhatsApp messages to real users without explicit human approval.
- Prefer sandbox numbers and development projects for tests.
- When uncertain, cite the exact Kapso docs page used.

## Key docs

- Build with AI: https://docs.kapso.ai/docs/build-with-ai
- Kapso WhatsApp MCP: https://docs.kapso.ai/docs/whatsapp/mcp
- CLI: https://docs.kapso.ai/docs/whatsapp/cli
- Chat SDK: https://docs.kapso.ai/docs/whatsapp/chat-sdk
- OpenClaw: https://docs.kapso.ai/docs/whatsapp/openclaw
- Hermes Agent: https://docs.kapso.ai/docs/whatsapp/hermes-agent
- Send messages: https://docs.kapso.ai/docs/whatsapp/send-messages/text
- Receive messages: https://docs.kapso.ai/docs/whatsapp/receive-messages
- Customer onboarding: https://docs.kapso.ai/docs/platform/customer-guide
- WhatsApp Flows: https://docs.kapso.ai/docs/whatsapp/flows/overview