> ## 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.

# Grok

> Connect BubblaV to Grok Bot and Grok Build via MCP to check chatbot performance, teach it new knowledge, and add the chat widget to your site

Connect BubblaV to Grok through the BubblaV MCP Server. Ask Grok Bot or Grok Build to check your chatbot's performance, find the questions it could not answer, teach it new knowledge, and add the chat widget to the site you are building. You do not need an API key.

## Why Connect Grok?

* **Analytics on demand**: Get a full report for any date range
* **Close content gaps**: See what your bot could not answer and add the missing answers
* **Routines**: Let a Grok Bot routine check your chatbot every week and report what it found
* **Install the widget from your project**: Grok Build gets your embed snippet and adds it to your code
* **No API key**: OAuth handles the connection

## Prerequisites

* A BubblaV account. You can create one during the sign-in step
* Grok Bot, or the Grok Build CLI

## Connect BubblaV

### Grok Bot

**1. Add the app**

Open **Connect apps**, search for **BubblaV**, and add it. You can also ask your Bot: *"Add the BubblaV app."* If BubblaV is not in the list yet, ask your Bot: *"Add the MCP server [https://www.bubblav.com/mcp](https://www.bubblav.com/mcp)."*

**2. Authorize BubblaV**

Select **Authenticate** (on the phone, **Authorize**). The BubblaV sign-in page opens. Sign in, select the website (chatbot) to connect, choose **Full access** or **Read only**, and approve. If you do not have a website, choose to create a chatbot without one.

**3. Try it**

Ask *"How is my BubblaV chatbot performing this month?"* or *"Which questions could my chatbot not answer last week?"*

### Grok Build (CLI)

Install the BubblaV plugin. It adds the MCP server and two skills: **add-chat-widget** and **manage-custom-tools**.

```bash theme={null}
grok plugin install bubblav-org/bubblav-grok
```

To add only the MCP server, without the skills:

```bash theme={null}
grok mcp add --transport http bubblav https://www.bubblav.com/mcp
```

Grok opens the BubblaV sign-in page the first time it uses the server. In the TUI, you can also open `/mcps`, select BubblaV, and press `i` to sign in.

After you approve, BubblaV creates an API key in your account for the connection. The key is named after the app that connected, for example **Grok**. Grok Bot connects through Cursor's connector service, so its key can show as **Cursor**.

## What You Can Ask

| Tool | What it does | Example prompt |
| - | - | - |
| `bubblav_read_report` | Full analytics report for a date range | "How is my chatbot performing this month?" |
| `bubblav_list_unanswered_questions` | Questions that got a low-confidence, fallback, or thumbs-down answer | "Which questions could my chatbot not answer last week?" |
| `bubblav_get_content_gaps` | Topics your knowledge base is missing | "What should I add to my knowledge base?" |
| `bubblav_search_knowledge` | Search what your chatbot knows | "Does my chatbot know our refund policy?" |
| `bubblav_add_knowledge` | Add a knowledge entry | "Add to my chatbot's knowledge: we are open Monday to Friday, 9 AM to 5 PM" |
| `bubblav_add_crawl_url` | Add a URL to crawl and index | "Index our new pricing page" |
| `bubblav_get_widget_snippet` | Get the code that adds the chat widget to your site | "Add the BubblaV chat widget to this Next.js app" |
| `bubblav_update_widget_appearance` | Update bot name, greetings, colors, position | "Match the widget color to our brand blue" |
| `bubblav_create_custom_tool` | Create a webhook custom tool (Pro+) | "Create a custom tool that calls our /orders/lookup endpoint" |

> [!NOTE]
>
> For the full tool reference, see the [MCP Server developer guide](https://docs.bubblav.com/developer-guide/mcp-server.md). For ready-to-use prompts, see [AI Agent Workflows](https://docs.bubblav.com/user-guide/ai-agent-workflows.md).

## Privacy

* One connection gives access to one website (chatbot)
* Conversations and leads can contain your visitors' names, email addresses, and messages. Grok sees this data when a tool returns it
* Grok Bot keeps the OAuth token on its connector service. The Bot calls tools without receiving the token
* BubblaV logs every tool call. See **Integrations → MCP Settings → Audit Logs**
* See the [Privacy Policy](https://www.bubblav.com/privacy)

## Rate Limits

MCP calls are metered separately from your chatbot messages, on a rolling 30-day window:

| Plan | MCP calls / month |
| - | - |
| Free | 100 |
| Pro | 5,000 |
| Custom | Unlimited |

When you exceed the limit, requests return a `429` with a `Retry-After` header. Check your usage under **Integrations → MCP Settings** in the dashboard.

## Disconnect or Switch Website

Revoke the API key for the connection in your BubblaV dashboard. Then connect BubblaV again and pick the website you want during sign-in.

## Troubleshooting

> [accordion] BubblaV shows 'Needs auth' or 'Disconnected' in Grok Bot
>
> * Open **Connect apps**, open BubblaV, and select **Authenticate** (or **Reconnect**).

> [accordion] BubblaV shows 'Disabled by team admin'
>
> * Your team's connector policy blocks BubblaV. Ask your admin to allow it.

> [accordion] Authorized the wrong website
>
> * Revoke the API key in BubblaV and connect again. Pick the correct website during sign-in.

> [accordion] Grok does not use BubblaV tools
>
> * In Grok Bot, type `@` and attach BubblaV to the task.
> * Name the task directly, for example *"Use BubblaV to get my widget snippet."*

## Next Steps

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

> [card] [Custom Tools](https://docs.bubblav.com/user-guide/integrations/custom-tools.md)
>
> Webhook tools you can create from Grok

> [card] [Cursor](https://docs.bubblav.com/user-guide/integrations/cursor.md)
>
> Use BubblaV from Cursor


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