# leporis-mcp

Remote MCP (Model Context Protocol) server for [Leporis](https://rstechie.in/whatsapp), RS-Techie's multi-tenant WhatsApp Business platform.

Exposes Leporis's public REST API (`api/v1/public.php`) as MCP tools so AI coding agents (Claude Code, Cursor, Antigravity, etc.) can send/read WhatsApp messages on your Leporis account directly from chat.

- **Endpoint:** `https://leporis.mcp.rstechie.in/mcp` (Streamable HTTP transport)
- **Auth:** stateless BYOK (bring your own key) — send your Leporis API key as `Authorization: Bearer <key>` on every request. Get a key from your Leporis dashboard under **WhatsApp → Integrations**. The server stores no credentials of its own.
- **Tools:** `send_message`, `list_contacts`, `get_contact`, `get_conversation_messages`

## Setup in your MCP client

See the "Connect via MCP" section on the Integrations page in your Leporis dashboard for exact per-client config (Claude Code, Cursor, Antigravity).

## Running locally

```bash
npm install
PORT=8806 node server.js
```

Requires `LEPORIS_API_BASE` (defaults to `https://rstechie.in/api/v1/public.php`) to point at a real Leporis instance.