{
  "markdown": "# Gavi WhatsApp API\n\nThe WhatsApp API built for how developers actually build in 2026. Works in Cursor, Claude Code, Codex, and Lovable.\n\n**MCP server** · **TypeScript SDK** · **Python SDK** · **Examples** · **$9.99/mo**\n\n[![npm](https://img.shields.io/npm/v/@gaviwhatsapp/whatsapp)](https://www.npmjs.com/package/@gaviwhatsapp/whatsapp)\n[![npm](https://img.shields.io/npm/v/@gaviwhatsapp/mcp)](https://www.npmjs.com/package/@gaviwhatsapp/mcp)\n[![PyPI](https://img.shields.io/pypi/v/gaviwhatsapp)](https://pypi.org/project/gaviwhatsapp/)\n\n---\n\n## What is this?\n\nA complete WhatsApp Business API platform with:\n\n- **MCP Server** — Type \"send a WhatsApp message\" in Cursor or Claude Code and it just works\n- **REST API** — 6 endpoints: send message, send template, send media, broadcasts, webhooks, contacts\n- **TypeScript SDK** — `npm install @gaviwhatsapp/whatsapp`\n- **Python SDK** — `pip install gaviwhatsapp`\n- **Dashboard** — Visual form builder, conversation flows, broadcast campaigns, analytics\n\n## Quick Start\n\n### Option 1: MCP Server (AI coding tools)\n\nAdd to `.cursor/mcp.json` or `.claude/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"gaviwhatsapp\": {\n      \"command\": \"npx\",\n      \"args\": [\"@gaviwhatsapp/mcp\", \"--api-key\", \"gv_YOUR_KEY\"]\n    }\n  }\n}\n```\n\nThen just ask: *\"Send a WhatsApp message to +919876543210 saying hello\"*\n\n### Option 2: TypeScript SDK\n\n```bash\nnpm install @gaviwhatsapp/whatsapp\n```\n\n```typescript\nimport { WhatsApp } from '@gaviwhatsapp/whatsapp'\n\nconst wa = new WhatsApp({ apiKey: process.env.GAVIWHATSAPP_API_KEY! })\nawait wa.send({ to: '+919876543210', text: 'Hello from my app!' })\n```\n\n### Option 3: Python SDK\n\n```bash\npip install gaviwhatsapp\n```\n\n```python\nfrom gaviwhatsapp import WhatsApp\n\nwa = WhatsApp(api_key=\"gv_YOUR_KEY\")\nwa.send(to=\"+919876543210\", text=\"Hello from my app!\")\n```\n\n### Option 4: REST API\n\n```bash\ncurl -X POST https://www.gaviventures.com/api/v1/messages \\\n  -H \"Authorization: Bearer gv_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"to\": \"+919876543210\", \"text\": \"Hello!\"}'\n```\n\n## Get an API Key\n\n1. Sign up at [gaviventures.com](https://www.gaviventures.com)\n2. Connect your WhatsApp Business Account\n3. Go to **Settings > API Keys**\n\n## Packages\n\n| Package | Description | Install |\n|---------|-------------|---------|\n| [`@gaviwhatsapp/mcp`](./mcp) | MCP server for Cursor, Claude Code, Codex | `npx @gaviwhatsapp/mcp` |\n| [`@gaviwhatsapp/whatsapp`](./sdk-ts) | TypeScript/Node.js SDK | `npm install @gaviwhatsapp/whatsapp` |\n| [`gaviwhatsapp`](./sdk-py) | Python SDK | `pip install gaviwhatsapp` |\n\n## Examples\n\n| Example | Description | Language |\n|---------|-------------|----------|\n| [send-message-ts](./examples/send-message-ts) | Send a text message | TypeScript |\n| [send-message-python](./examples/send-message-python) | Send a text message | Python |\n| [broadcast-campaign](./examples/broadcast-campaign) | Send personalized broadcast from CSV | TypeScript |\n| [webhook-receiver](./examples/webhook-receiver) | Receive incoming WhatsApp messages | TypeScript |\n\n## API Reference\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/messages` | Send a text message |\n| POST | `/api/v1/messages/template` | Send a template message |\n| POST | `/api/v1/messages/media` | Send media (image/video/document) |\n| POST | `/api/v1/broadcasts` | Send to multiple recipients |\n| POST | `/api/v1/webhooks` | Register a webhook |\n| GET | `/api/v1/webhooks` | List webhooks |\n\nFull docs: [gaviventures.com/docs/api](https://www.gaviventures.com/docs/api)\n\n## Pricing\n\n| Plan | Price | Includes |\n|------|-------|----------|\n| API | $9.99/mo | API, SDKs, MCP server, webhooks, broadcasts |\n| Pro | $24.99/mo | Everything + visual builder, forms, flows, analytics |\n\n7-day free trial. No credit card required. Meta per-message charges billed directly to your WhatsApp Business Account.\n\n## Links\n\n- [Website](https://www.gaviventures.com)\n- [API Documentation](https://www.gaviventures.com/docs/api)\n- [npm: @gaviwhatsapp/whatsapp](https://www.npmjs.com/package/@gaviwhatsapp/whatsapp)\n- [npm: @gaviwhatsapp/mcp](https://www.npmjs.com/package/@gaviwhatsapp/mcp)\n- [PyPI: gaviwhatsapp](https://pypi.org/project/gaviwhatsapp/)\n\n## License\n\nSource code in this repository is provided for reference and integration purposes. The WhatsApp API service requires a paid subscription. See [gaviventures.com](https://www.gaviventures.com) for terms.\n",
  "bytes": 4459,
  "sha": "76ef32f1526c00ca59372367d5b538043a71bd67f5a826a98b95728c81c8e9ea",
  "repo_slug": "gaviwhatsapp/gaviwhatsapp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gaviwhatsapp_whatsapp_f1f4bac4/readme"
}