Ask your agent in plain language. Each of these maps to a real tool on the server.
list_bots
List all bots in a Botpress workspace. Returns bot names, IDs, deployment status, and timestamps. Supports pagination for workspaces with many bots. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_state
Get or set persistent state for a bot. State is a key-value store scoped to a conversation, user, bot, or workflow. Useful for maintaining context across interactions. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_files
List, retrieve, download, delete, or search files in a bot's file storage. Use search for indexed knowledge files. Upsert creates or updates file metadata and can upload UTF-8 text content. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
list_bot_issues
List or retrieve issues reported for a bot. Issues help diagnose and track problems with bot behavior and conversation flows. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
send_message
Send a message to a conversation via the Runtime API. Supports text, image, audio, video, file, location, card, carousel, choice, and dropdown message types. The **payload** must match the expected format for the given **messageType**. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_table_rows
Create, read, update, delete, upsert, or search rows in a Botpress table. Use **find** for filtered or semantic search queries. Use **upsert** for idempotent inserts using a key column. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_bot
Create, retrieve, update, or delete a Botpress bot. Use **action** to specify the operation. For updates, provide only the fields you want to change. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
list_messages
List messages in a bot's conversations. Optionally filter by conversation ID. Returns message content, sender, timestamps, and direction (incoming/outgoing). Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
get_bot_analytics
Retrieve analytics data for a bot including conversation counts, message volumes, and user engagement metrics. Optionally filter by date range. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
list_integrations
List available integrations in a Botpress workspace. Search by name, filter by visibility (public/private), or retrieve a specific integration by ID or name. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_table
Create, retrieve, update, delete, or list tables in a bot's structured data store. Tables are used to store custom data like user profiles, labels, or extracted content. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
create_event
Send an event to a bot for asynchronous processing. Events trigger bot workflows and can be scoped to a conversation or user. Use this to push external data or signals into a bot. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_user
Create, retrieve, update, delete, or list bot users via the Runtime API. Users represent people interacting with a bot within a specific integration. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_conversation
Create, get, update, delete, or list bot conversations and manage their participants. Call list_workspaces then list_bots to discover bot IDs. Creation requires an installed integration channel; use the integration identity fields to act as that integration.
get_bot_logs
Retrieve activity logs for a bot. Useful for debugging, monitoring bot behavior, and auditing conversation flows. Call list_workspaces to discover workspace IDs, then list_bots to discover bot IDs.
manage_message
Get an existing message or delete it. Discover bot IDs with list_bots and message IDs with list_messages.
list_workspaces
Discover workspaces accessible to the connected account. Use their workspace IDs with list_bots and other admin tools.
get_account
Get the account identity associated with the connected Personal Access Token.
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.
Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.
Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.
Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.
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.
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.
Manage Botpress bots, conversations, participants, messages, users, structured tables, and knowledge files. Discover accounts and workspaces, configure installed integrations and declared states/events, upload and download text files, and inspect bot analytics, logs, and issues.
Common questions about connecting Botpress to AI agents with Metorial.
