> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bubblav.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Muse

> Connect BubblaV to Meta Muse to check chatbot performance, find unanswered questions, teach your chatbot, and change its settings by chat

Connect BubblaV to **Muse**, Meta's AI agent. Ask Muse how your chatbot performs, which questions it could not answer, and what visitors ask most. Muse can also add knowledge and change your chatbot's settings for you. The connection uses OAuth, so you do not need an API key.

> [!NOTE]
>
> The BubblaV connector is submitted to the Muse connector directory and waits for Meta's review. When Meta approves it, you find it in Muse under **Settings → Connectors**. Muse is available in the US and Canada.

## Why Connect Muse?

* **Answers from your own data**: Muse reads your BubblaV reports, conversations and knowledge base. A browser cannot see this data, because it is behind your login.
* **Close content gaps**: Muse finds the questions your chatbot could not answer and adds the missing answers.
* **Change settings by chat**: Update the chatbot instructions, greeting, colors, forms and Help Center articles.
* **Read only if you want**: Give Muse access that can read but not change anything.

## Prerequisites

* A BubblaV account. You can sign up for free during the connection.
* A Muse account in a region where Muse is available.

## Connect BubblaV to Muse

**1. Open the connector**

In Muse, go to **Settings → Connectors** and select **BubblaV**. You can also ask Muse a BubblaV question, for example *"How is my BubblaV chatbot doing this month?"*. Muse then offers to connect.

**2. Sign in to BubblaV**

Muse opens the BubblaV sign-in page. Sign in, or create an account. If you have no chatbot yet, choose **I don't have a website** to create one from text or a file.

**3. Choose the chatbot and the access level**

Select the chatbot (website) to connect. Then choose the access level:

* **Full access**: Muse can read your chatbot data and make the changes you ask for.
* **Read only**: Muse can read your chatbot data but cannot change anything.

Select **Authorize**, then **Return to Muse**.

**4. Try it**

Ask Muse *"Which questions could my chatbot not answer last week?"* or *"Give me this month's chatbot report."*

An API key named **Muse** is created in your BubblaV account for this connection. Muse can only access the chatbot you selected.

## Approvals in Muse

Muse asks for your approval before it uses a connector tool. You can choose **Allow once**, **Always allow** or **Deny**. Muse asks for approval every time it uses a sensitive tool (see the table below), and you cannot set these to **Always allow**.

## Tools

Muse receives the tools below. **Read** tools never change data. **Write** tools change your chatbot. **Sensitive write** tools delete data permanently, or let your chatbot send visitor data to an outside web address. With **Read only** access, Muse sees only the Read tools.

| Tool | Class | What it does |
| - | - | - |
| `bubblav_read_report` | Read | Analytics report for a date range: conversations, messages, AI resolution rate, ratings, response times, top countries. |
| `bubblav_list_unanswered_questions` | Read | Visitor questions with low-confidence, fallback or thumbs-down answers. |
| `bubblav_get_content_gaps` | Read | Questions the chatbot struggled to answer, with how often they were asked. |
| `bubblav_get_most_asked_questions` | Read | The questions visitors ask most. |
| `bubblav_get_answerable_questions` | Read | Questions the chatbot can answer from its knowledge. |
| `bubblav_get_hourly_activity` | Read | Conversations and tickets per hour of the day. |
| `bubblav_list_conversations` | Read | List conversations, with filters for date, channel and status. |
| `bubblav_get_conversation` | Read | One conversation with its messages. |
| `bubblav_search_conversations` | Read | Full-text search across conversation messages. |
| `bubblav_search_knowledge` | Read | Search the chatbot's knowledge base. Shown after the website has indexed content. |
| `bubblav_list_knowledge_sources` | Read | Everything the chatbot is trained on: text, files, crawled pages, Notion, Google Docs, Zendesk. |
| `bubblav_list_crawl_urls` | Read | Crawl URLs, sitemaps and llms.txt URLs. |
| `bubblav_get_crawl_status` | Read | Crawl and indexing progress. |
| `bubblav_get_website_settings` | Read | Website settings and chatbot instructions. |
| `bubblav_get_widget_appearance` | Read | Chat widget name, greetings, colors and position. |
| `bubblav_get_widget_snippet` | Read | The code that adds the chat widget to a website. |
| `bubblav_get_search_widget_config` | Read | AI search box settings. |
| `bubblav_get_search_widget_snippet` | Read | The code that adds the AI search box to a website. |
| `bubblav_list_forms` | Read | AI forms and their fields. |
| `bubblav_get_help_center` | Read | Help Center groups and articles. |
| `bubblav_list_custom_tools` | Read | Custom webhook tools and their status. |
| `bubblav_list_flows` | Read | Flows (automations), with trigger and run counts. Pro plan. |
| `bubblav_get_flow` | Read | One flow and its steps. Secrets are removed. Pro plan. |
| `bubblav_add_knowledge` | Write | Add a text entry to the knowledge base. |
| `bubblav_sync_ticket_to_knowledge` | Write | Save a resolved ticket as a knowledge article. Pro plan. |
| `bubblav_upload_knowledge_file` | Write | Index a PDF, DOCX, DOC, TXT or Markdown file (max 10 MB). |
| `bubblav_add_crawl_url` | Write | Add a page to crawl and index. |
| `bubblav_update_sitemaps` | Write | Replace the sitemap and llms.txt URLs used for crawling. |
| `bubblav_update_website_settings` | Write | Change the chatbot instructions and website settings. |
| `bubblav_update_widget_appearance` | Write | Change the chat widget name, greetings, colors and position. |
| `bubblav_update_search_widget_config` | Write | Change the AI search box settings. |
| `bubblav_create_form` | Write | Create an AI form. |
| `bubblav_update_form` | Write | Change an AI form. |
| `bubblav_create_help_center_group` | Write | Create a Help Center group. |
| `bubblav_update_help_center_group` | Write | Rename, publish or unpublish a Help Center group. |
| `bubblav_create_help_center_article` | Write | Create a Help Center article. |
| `bubblav_update_help_center_article` | Write | Change, publish or unpublish a Help Center article. |
| `bubblav_reorder_help_center` | Write | Change the order of Help Center groups or articles. |
| `bubblav_create_custom_tool` | Sensitive write | Create a webhook tool. The chatbot can then send data from chats to that web address. Pro plan. |
| `bubblav_update_custom_tool` | Sensitive write | Change a webhook tool, including its web address. Pro plan. |
| `bubblav_toggle_custom_tool` | Sensitive write | Turn a webhook tool on or off for the chatbot. Pro plan. |
| `bubblav_delete_knowledge` | Sensitive write | Permanently delete a knowledge entry. |
| `bubblav_delete_crawl_url` | Sensitive write | Permanently remove a crawl URL. |
| `bubblav_delete_form` | Sensitive write | Permanently delete a form and its submissions. |
| `bubblav_delete_help_center_group` | Sensitive write | Permanently delete a Help Center group and its articles. |
| `bubblav_delete_help_center_article` | Sensitive write | Permanently delete a Help Center article. |
| `bubblav_delete_custom_tool` | Sensitive write | Permanently delete a webhook tool. Pro plan. |
| `bubblav_delete_flow` | Sensitive write | Permanently delete a flow and its run history. Pro plan. |

### Results that complete later

Some write tools start work that finishes after the tool returns:

* `bubblav_add_knowledge`, `bubblav_upload_knowledge_file` and `bubblav_sync_ticket_to_knowledge` queue the content for indexing. It becomes searchable within a few minutes.
* `bubblav_add_crawl_url` and `bubblav_update_sitemaps` queue a crawl. Muse checks progress with `bubblav_get_crawl_status`.

### Errors

When a tool cannot run, Muse receives an error message that it can tell you. Examples: a plan limit (`PLAN_REQUIRED` for Pro tools on other plans), an item that does not exist, or a missing argument. With **Read only** access, a write tool returns an error that tells you to reconnect with **Full access**.

## What Muse Cannot Access

To protect your visitors' privacy and your account's security, Muse is limited. These things still work in Claude, Cursor and the BubblaV dashboard:

* **Visitor contact details**: Muse never sees a visitor's email, name or country, or your captured leads. Reports show only totals. BubblaV trims conversation, report and question results to what Muse needs, and masks email addresses and phone numbers inside chat messages.
* **Flows**: Muse can list and read flows, but it cannot create or edit them, and it cannot see flow run history.
* **API keys and secrets**: Muse cannot create, list or revoke API keys. It never sees a tool's secret key or a flow's webhook secret.
* **URL scraping and tool call logs**: not available.
* **Admin tools**: BubblaV staff tools are never available in Muse.

## Rate Limits

MCP calls are counted per BubblaV account, for each billing period, across all your websites:

| Plan | MCP calls per billing period |
| - | - |
| Free | 100 |
| Pro | 5,000 |
| Custom | Set in your contract |

When you reach the limit, BubblaV answers with HTTP `429` and a `Retry-After` header until the next billing period starts. See your usage under **Settings → API Keys** in the dashboard.

## Disconnect or Change Access

To disconnect, remove BubblaV in Muse under **Settings → Connectors**, or revoke the **Muse** API key under **Settings → API Keys** in the BubblaV dashboard. To connect a different chatbot or change between **Full access** and **Read only**, revoke the key and connect again.

## Troubleshooting

> **I cannot find BubblaV in Muse**
>
> * The connector is visible after Meta approves it. Muse is available in the US and Canada.

> **Muse says it cannot make changes**
>
> * You connected with **Read only** access. Revoke the **Muse** API key in BubblaV and connect again with **Full access**.

> **I connected the wrong chatbot**
>
> * Revoke the **Muse** API key in BubblaV, then connect again and select the correct website.

> **Muse cannot read a web page for me**
>
> * URL scraping is not available in Muse. To teach your chatbot a page, ask Muse to add it with `bubblav_add_crawl_url`.

## Next Steps

> **[MCP Server](https://docs.bubblav.com/developer-guide/mcp-server.md)**
>
> Full tool reference, OAuth details and other MCP clients

> **[Content Gaps](https://docs.bubblav.com/user-guide/knowledge/content-gaps.md)**
>
> Find and fix the questions your chatbot cannot answer

> **[AI Agent Workflows](https://docs.bubblav.com/user-guide/ai-agent-workflows.md)**
>
> Recipes to diagnose gaps and tune your bot


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.