# BotPenguin — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/botpenguin

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_botpenguin?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/botpenguin/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/botpenguin/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/botpenguin/skill.md
Postman collection (v2.1): https://mcp.ai/botpenguin/postman.json

## Tools
- botpenguin_get_template_dynamic_fields(template_id: string) — Return the dynamic key-value fields required by a BotPenguin WhatsApp template.
- botpenguin_import_contacts(contacts: object[]) — Import contacts in bulk into BotPenguin. Existing contacts may be updated, and the operation does not return contact IDs.
- botpenguin_list_inbox_contacts(page?: integer, user_interacted?: boolean) — Return one page of BotPenguin inbox contacts filtered by whether the contact has interacted with a bot.
- botpenguin_list_segments() — List the contact segments configured in the connected BotPenguin account, including each segment's filter definition and contact count.
- botpenguin_list_whatsapp_bots() — List WhatsApp bots available to the connected BotPenguin account for use with plugin template tools.
- botpenguin_list_whatsapp_templates(bot_id: string) — List WhatsApp templates available to a BotPenguin bot.

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

## Links
Docs: https://mcp.ai/docs/mcps/botpenguin
Website: https://mcp.ai/mcps/botpenguin