# BotPenguin — how to use (mcp.ai)

Connect your BotPenguin account and use 6 tools for AI chatbots straight from your AI agent. Connect with your own API key. BotPenguin is an AI chatbot platform for managing contacts, conversations, bot integrations, and cross-platform customer messaging.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_botpenguin?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `botpenguin_get_template_dynamic_fields`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/botpenguin`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/botpenguin/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/botpenguin/get/template/dynamic/fields` — Return the dynamic key-value fields required by a BotPenguin WhatsApp template.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/botpenguin/import/contacts` — Import contacts in bulk into BotPenguin. Existing contacts may be updated, and the operation does not return contact IDs.
  - body: { contacts: object[] }
- `POST https://api.mcp.ai/api/botpenguin/list/inbox/contacts` — Return one page of BotPenguin inbox contacts filtered by whether the contact has interacted with a bot.
  - body: { page?: integer, user_interacted?: boolean }
- `POST https://api.mcp.ai/api/botpenguin/list/segments` — List the contact segments configured in the connected BotPenguin account, including each segment's filter definition and contact count.
- `POST https://api.mcp.ai/api/botpenguin/list/whatsapp/bots` — List WhatsApp bots available to the connected BotPenguin account for use with plugin template tools.
- `POST https://api.mcp.ai/api/botpenguin/list/whatsapp/templates` — List WhatsApp templates available to a BotPenguin bot.
  - body: { bot_id: string }

## Example prompts
- "What can I do in BotPenguin?"
- "Show me a summary of my BotPenguin account"

## More
- Page: https://mcp.ai/botpenguin
- Agent spec (llms.txt): https://mcp.ai/botpenguin/llms.txt
- Postman collection: https://mcp.ai/botpenguin/postman.json