Ask your agent in plain language. Each of these maps to a real tool on the server.
get_user
Retrieve audience/user information for a specific chatbot user. Returns profile data including name, email, timezone, and any custom attributes. The user ID can be found in Reports & Insights > Audience. Call list_bots to discover the bot ID first.
list_cms_items
Retrieve items from a CMS entity. Supports pagination and filtering by name or status. Items are data objects with attributes defined by their parent entity. Call list_bots to discover the bot ID first.
manage_cms_item
Create, update, or delete a CMS item within an entity. Items are data objects with field values defined by their parent entity's schema. Use "create" to add a new item, "update" to modify an existing item's fields, or "delete" to remove it. Call list_bots to discover the bot ID first.
get_bot
Retrieve details for a specific chatbot by its ID, including its name and team association. Call list_bots to discover the bot ID first.
manage_cms_entity
Create, update, or delete a CMS entity for a bot. CMS entities define the structure (fields) for a collection of content items. Use "create" to make a new entity with optional fields, "update" to rename an existing entity, or "delete" to remove it. Call list_bots to discover the bot ID first.
broadcast_message
Send text messages to a specific chatbot user via the BotStar broadcast API. Requires a bot-level access token (configured as "botToken" in authentication). The user must be an existing audience member of the bot.
list_bots
Retrieve all chatbots associated with your BotStar account. Returns bot IDs, names, and team names. Bot IDs are needed for interacting with other resources like users, CMS, and attributes.
get_cms_entity
Retrieve a CMS entity with its field definitions and unique field keys for item updates. Call list_cms_entities to discover entity IDs. Call list_bots to discover the bot ID first.
list_cms_entities
Retrieve all CMS entities for a specific bot. CMS entities are collections of items that share the same attributes (fields). Use entity IDs to manage individual items within each entity. Call list_bots to discover the bot ID first.
manage_bot_attributes
List, create, update, or delete bot-level attributes (variables). Bot attributes store global data for a bot and support multiple data types. Use "list" to view all attributes, "create" to add one, "update" to modify an existing attribute's value or description, or "delete" to remove one. Call list_bots to discover the bot ID first.
send_message
Send a formatted message to a Facebook audience user via the BotStar Public API. Supports message tags for subscription messaging compliance (CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE).
update_user
Update a chatbot user's profile information and custom attributes. You can update standard fields like name, email, gender, birthday, or set custom attribute values. Call list_bots to discover the bot ID first.
create_user_attribute
Create a new custom attribute field for users of a specific bot. Once created, this attribute can be set on individual users. Supported types are string, number, date, and boolean. Call list_bots to discover the bot ID first.
publish_bot
Publish a bot to the live environment. This makes all draft changes available to real users on the connected platforms (website, Messenger). Call list_bots to discover the bot ID first.
create_bot
Create an empty chatbot in your BotStar account and return its ID. Build its conversation flow in the BotStar editor before publishing it.
get_cms_item
Retrieve one CMS item and its field values. Call list_cms_entities and list_cms_items to discover entity and item IDs. Call list_bots to discover the bot ID first.
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.
Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.
Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.
Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.
Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.
Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.
Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.
Manage chatbots, broadcast messages, and handle CMS content on the BotStar platform. List and retrieve bots, send messages to specific chatbot users, manage CMS entities and items for product catalogs and digital content, access and update audience/user data with custom fields and tags, and control a livechat website widget programmatically. Supports webhook events for new subscribers, user attribute updates, human takeover requests, new tags, CMS item creation, and checkpoint records.
Common questions about connecting Botstar to AI agents with Metorial.
