# Chatforma — MCP server on mcp.ai
> Connect your Chatforma account and use 10 tools for AI chatbots straight from your AI agent. Connect with your own API key. Chatforma is a chatbot automation platform for managing bots, users, segments, broadcasts, dialogs, forms, notifications, and variables.

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

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

## Tools
- chatforma_get_user_variable(bot_id: integer, bot_user_id: integer, variable_id: integer) — Get the current value of one bot variable for one bot user.
- chatforma_list_bots() — List bots belonging to the connected Chatforma account so their IDs can be used in bot-scoped tools.
- chatforma_list_dialog_messages(bot_id: integer, user_id: integer, per_page?: integer, next_cursor?: string) — Return one page of messages exchanged in a specific user's bot dialog, with a cursor for continuing the history.
- chatforma_list_predefined_messages(bot_id: integer) — List predefined messages configured in a bot so a message ID can be selected for sending.
- chatforma_list_segments(bot_id: integer) — List the user segments configured for a bot, including segment IDs needed for targeted sends.
- chatforma_list_users(view?: string, bot_id: integer, deleted?: boolean, per_page?: integer, segment_id?: integer|string, next_cursor?: string) — List a bot's users, members of one segment, or users with open dialogs; choose the view that matches the task.
- chatforma_list_variables(bot_id: integer) — List variables configured for a bot, including IDs and types needed to read user-specific values.
- chatforma_send_dialog_message(bot_id: integer, message: string, user_id: integer, idempotency_key: string) — Immediately send a user-visible text message into a specific user's bot dialog. This irreversible action may contact a real user.
- chatforma_send_predefined_message(bot_id: integer, run_at?: string, message_id: integer|string, segment_id?: integer|string, bot_user_id?: integer, recipient_type: string) — Send a configured bot message to one user or dispatch it to a segment. This irreversible action may contact one or many real users.
- chatforma_send_text_dispatch(bot_id: integer, run_at?: string, content: string, segment_id?: integer|string, bot_user_id?: integer, recipient_type: string) — Create a user-visible text dispatch for one bot user or a segment. Delivery may be immediate or scheduled where supported and cannot be undone through this API.

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

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