# Botsonic — how to use (mcp.ai)

Connect your Botsonic account and use 12 tools for AI chatbots straight from your AI agent. Connect with your own API key. Botsonic is a no-code AI chatbot builder that enables users to create and integrate AI chatbots into their websites without any coding knowledge.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_botsonic?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `botsonic_bulk_upload_urls`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/botsonic`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/botsonic/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/botsonic/bulk/upload/urls` — Tool to bulk upload URLs for bot training. Use when you need to upsert multiple document URLs into a bot in one request.
  - body: { urls: string[], ability_id?: string, is_crawled?: boolean, is_sitemap?: boolean, sitemap_id?: string, sitemap_root?: string }
- `POST https://api.mcp.ai/api/botsonic/create/starter/question` — Tool to create a new starter question for the bot. Use when you need to add a preset question-answer pair that users can quickly select.
  - body: { order?: integer, answer: string, question: string }
- `POST https://api.mcp.ai/api/botsonic/delete/starter/question` — Deletes a specific starter question from a bot using its unique identifier. This operation is destructive and permanent. First retrieve available starter questions using the Get All Starter Questions 
  - body: { id: string }
- `POST https://api.mcp.ai/api/botsonic/delete/uploaded/file` — Delete a specific uploaded file/bot data entry by its unique identifier. This permanently removes the file from the bot's training data. Use this action when you need to clean up outdated content, rem
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/botsonic/get/all/bot/data` — Tool to retrieve all data associated with the bot, including files and resources. Use when you need a comprehensive export of bot assets for backup or inspection.
  - body: { page?: integer, size?: integer, sort_by?: string, sort_order?: string, search_query?: string }
- `POST https://api.mcp.ai/api/botsonic/get/all/bots` — Retrieve all bots associated with your account. Supports pagination, search, and sorting to efficiently manage and query bot configurations. Use this when you need to list, search, or filter existing 
  - body: { page?: integer, size?: integer, sort_by?: string, sort_order?: string, search_query?: string, workspace_id?: string }
- `POST https://api.mcp.ai/api/botsonic/get/all/conversations` — Tool to retrieve all conversations related to the bot. Use after authentication when you need a paginated list of conversation threads for review or analytics.
  - body: { page?: integer, size?: integer, sort_by?: string, sort_order?: string, search_query?: string, updated_after?: string, updated_before?: string }
- `POST https://api.mcp.ai/api/botsonic/get/all/conversations/with/source` — Tool to retrieve all conversations with source information. Use when you need detailed conversation data including source tracking, user form data, and comprehensive metadata for analytics or conversa
  - body: { page?: integer, size?: integer, sort_by?: string, chat_ids?: string[], sort_order?: string, search_query?: string, updated_after?: string, updated_before?: string }
- `POST https://api.mcp.ai/api/botsonic/get/all/faqs` — Retrieve all frequently asked questions (FAQs) associated with your bot in paginated format. Returns a list of FAQ entries with their questions, answers, status, and metadata. Supports filtering by se
  - body: { page?: integer, size?: integer, sort_by?: string, sort_order?: string, search_query?: string }
- `POST https://api.mcp.ai/api/botsonic/get/all/starter/presets` — Tool to retrieve all starter presets for a bot by bot ID. Use when you need to fetch the bot's welcome message and starter questions configured for user interactions.
- `POST https://api.mcp.ai/api/botsonic/get/all/starter/questions` — Tool to retrieve all starter questions. Use after authenticating when you need to list the bot’s opening prompts.
  - body: { page?: integer, size?: integer, sort_by?: string, sort_order?: string, search_query?: string }
- `POST https://api.mcp.ai/api/botsonic/update/starter/question` — Tool to update an existing starter question by its unique identifier. Use after confirming the ID and desired updates.
  - body: { id: string, order?: integer, answer?: string, question?: string }

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

## More
- Page: https://mcp.ai/botsonic
- Agent spec (llms.txt): https://mcp.ai/botsonic/llms.txt
- Postman collection: https://mcp.ai/botsonic/postman.json