list_teams
List Teams
Retrieve all teams accessible with the current API key. Returns team details including name, status, plan info, and usage statistics (bot count, source count, question count).
Ask your agent in plain language. Each of these maps to a real tool on the server.
list_teams
Retrieve all teams accessible with the current API key. Returns team details including name, status, plan info, and usage statistics (bot count, source count, question count).
rate_answer
Rate a bot's answer as positive, negative, or neutral (reset). Use the answerId from a chat response to submit the rating. Call list_teams to discover accessible team IDs.
create_source
Add a new training source to a bot. Supports URL, sitemap, YouTube, RSS, Q&A pairs, and file-based sources. For file uploads, first use the **Get Upload URL** tool to obtain a presigned URL, upload the file, then pass the returned file path here. Call list_teams to discover accessible team IDs.
delete_question
Soft-delete a question from the bot's question history. The question is flagged as deleted and its content is cleared. Call list_teams to discover accessible team IDs.
get_conversation
Retrieve full details of a conversation session including the complete message history, summary, sentiment, resolution/escalation status, and user metadata. Call list_teams to discover accessible team IDs.
delete_bot
Permanently delete a bot and all its associated sources and data. This action cannot be undone. Call list_teams to discover accessible team IDs.
list_sources
List a page of training sources for a bot. Call list_teams to discover team IDs. Returns source status and indexing counts, with pagination for retrieving the next page.
update_bot
Update an existing bot's settings including name, description, AI model, custom prompt instructions, privacy, widget appearance (color, icon, alignment), allowed domains, branding, support link, and UI labels. Only provided fields are updated. Call list_teams to discover accessible team IDs.
delete_conversation
Delete a conversation session and all its messages from a bot. Requires bot edit permissions. Call list_teams to discover accessible team IDs.
delete_source
Delete a training source from a bot. The source data will be removed from the bot's index. Sources may still appear in chat results for several minutes while being fully removed. Call list_teams to discover accessible team IDs.
list_questions
Retrieve question and answer history for a bot. Supports filtering by rating, escalation status, answer capability, date range, and IP hash. Returns paginated results with question text, answer, sources, and metadata. Call list_teams to discover accessible team IDs.
get_bot
Retrieve full details for a specific bot including its configuration, model, status, widget settings, labels, and usage statistics. Call list_teams to discover accessible team IDs.
record_escalation
Mark an individual answer in question history as escalated to human support. This records question-level escalation and does not confirm escalation of a whole conversation. Call list_teams to discover accessible team IDs.
create_bot
Create a new AI chatbot for a team selected with list_teams. Requires a name, description, privacy level, and language. Optionally specify the AI model or duplicate an existing bot.
get_upload_url
Get a presigned upload URL for uploading a file to use as a bot training source. After uploading the file to the returned URL, use the returned file path with the **Create Source** tool. Call list_teams to discover accessible team IDs.
list_conversations
Retrieve paginated conversation sessions for a bot. Returns conversation summaries including title, sentiment, resolution status, escalation status, and timestamps. Use **Get Conversation** to retrieve full message history. Call list_teams to discover accessible team IDs.
list_bots
List all bots for a team selected with list_teams. Returns each bot's name, description, model, status, and usage statistics.
ask_question
Send a question to a DocsBot AI agent and receive an answer with source citations. Supports multi-turn conversations by reusing the same conversationId, multimodal inputs via image URLs, and configurable parameters like reasoning effort and context items. Call list_teams to discover accessible team IDs.
get_team
Retrieve a team’s current usage and plan limits. Call list_teams to discover accessible team IDs.
manage_source
Retry a failed training source or update its dashboard title without reindexing. Call list_teams and list_sources to discover IDs. Title updates support URL lists, sitemaps, website sources, and multi-file documents; other source types return a provider conflict.
get_source
Inspect a training source, including ingest progress, warnings, indexed URLs, FAQ pairs, and multi-file filenames. Call list_teams to discover team IDs and list_sources to discover source IDs.
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 and manage custom AI chatbots, discover accessible teams, inspect usage, and train bots on documentation, websites, and uploaded content. Inspect source ingestion, retry failed sources, update source titles, ask questions in persistent conversations with source citations, rate answers, and retrieve question and conversation history.
Common questions about connecting Docsbot Ai to AI agents with Metorial.