list_messages
List Messages
Retrieve the message history for a conversation. Returns all messages exchanged between users and the bot, including message type, text, and metadata.
Ask your agent in plain language. Each of these maps to a real tool on the server.
list_messages
Retrieve the message history for a conversation. Returns all messages exchanged between users and the bot, including message type, text, and metadata.
manage_dataset
Create, update, delete, or fetch datasets. Datasets are structured collections of knowledge that bots use to generate informed responses. Manage both the dataset container and individual records within it.
get_task
Inspect a background task, including execution status, outcome, schedule and associated bot or contact. Use list_resources with resourceType tasks to discover task IDs.
manage_integration
Create, update, delete, or fetch integrations (deployment channels). Integrations connect bots to platforms like Slack, Discord, WhatsApp, web widgets, Sitemap, Notion, and more. Each integration type has its own configuration.
manage_space
Create, update, delete, or fetch spaces. Spaces are collaborative environments for organizing conversations, contacts, and shared resources in isolated workspaces.
manage_skillset
Create, update, delete, or fetch skillsets and their abilities. Skillsets define what actions AI agents can perform. Abilities are individual actions within a skillset, defined through natural language instructions.
conversation_feedback
Submit upvote or downvote feedback on conversations or individual messages. Helps improve bot performance and gathers user sentiment data.
manage_conversation
Create, update, delete, or fetch conversations. Conversations are interactive sessions between users and AI bots. Supports creating new conversations linked to bots, updating settings, and retrieving conversation details.
manage_contact
Create, update, delete, fetch, or ensure contacts. Contacts represent end-users interacting with your chatbots. The "ensure" action creates a contact if it doesn't exist or retrieves it if it does. Also supports listing a contact's conversations.
list_models
Discover available AI models, their identifiers, providers and token limits before configuring a bot or sending a completion.
manage_memory
Create, update, delete, fetch, or search memories. Memories are persistent data units that store information associated with bots and contacts, enabling context recall and personalized experiences across conversations. Supports semantic search for finding relevant memories.
send_message
Send a message in a conversation and optionally receive the bot's response. Can also use the stateless complete endpoint for one-shot interactions without managing conversation state.
manage_bot
Create, update, delete, or fetch ChatBotKit bots. Bots are conversational AI systems with a backstory, AI model, dataset, and skillset. Use this to configure bot behavior, personality, and capabilities.
list_resources
List resources across ChatBotKit: bots, conversations, datasets, skillsets, contacts, memories, integrations, files, spaces, secrets, tasks, or blueprints. Supports cursor-based pagination.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Build, manage, and deploy AI chatbots and conversational agents. Create and configure bots with custom backstories, AI models (OpenAI, Anthropic, etc.), datasets, and skillsets. Manage conversations with streaming responses, function calling, and context-aware memory. Import knowledge from web pages, PDFs, DOCX, and Notion into datasets. Define skillsets with custom abilities for actions like web fetching and email sending. Track and manage contacts with personalized experiences and scheduled actions. Deploy bots to Slack, Discord, WhatsApp, Microsoft Teams, Google Chat, Twilio SMS, and web widgets. Organize resources into spaces and blueprints for team collaboration. Extract structured data from conversations using custom schemas. Manage files, secrets, audit logs, and content moderation settings. Support multi-tenancy via the Partner API with sub-account creation and impersonation.
Common questions about connecting Chatbotkit to AI agents with Metorial.