# BotMape — MCP server on mcp.ai
> Connect your BotMape account and use 8 tools for AI chatbots straight from your AI agent. Connect with your own API key. BotMape provides APIs for creating and managing AI agents, knowledge bases, conversations, messages, and usage analytics.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_botmape?ms=1787296080000
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/botmape/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/botmape/<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/botmape/skill.md
Postman collection (v2.1): https://mcp.ai/botmape/postman.json

## Tools
- botmape_add_knowledge(content: string, metadata?: object, ai_agent_id: integer) — Add and automatically embed training content in one AI agent's knowledge base, optionally with source or categorization metadata.
- botmape_create_ai_agent(name: string, description?: string, primary_color?: string, system_prompt?: string, welcome_message?: string, confirm_permanent_creation: boolean) — Permanently create a BotMape AI agent. BotMape provides no documented delete-agent API, so this toolkit cannot remove it afterward, and creation may permanently consume a plan-limited agent slot. Requ
- botmape_delete_knowledge_entry(ai_agent_id: integer, knowledge_entry_id: integer) — Permanently delete one knowledge-base entry from an AI agent using both the agent ID and knowledge entry ID.
- botmape_get_ai_agent(ai_agent_id: integer) — Return the detailed configuration, behavior prompt, appearance, and active state of one AI agent by ID.
- botmape_get_platform_analytics() — Return account-wide BotMape message and conversation totals, daily activity, averages, and per-agent statistics.
- botmape_list_ai_agents() — Return all AI agents owned by the connected BotMape account, including the IDs needed by single-agent, chat, and knowledge tools.
- botmape_list_knowledge_entries(ai_agent_id: integer) — Return all knowledge-base entries currently attached to one AI agent, including entry IDs needed for deletion.
- botmape_send_message_to_ai_agent(message: string, visitor_id?: string, ai_agent_id: integer, visitor_name?: string, visitor_email?: string, conversation_id?: string) — Immediately send a visitor message to an AI agent, creating a conversation or continuing the supplied conversation, and return the generated reply. This permanently adds chat history.

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

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