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

# Cursor

> Connect BubblaV to Cursor via MCP to add the chat widget to your site, check chatbot performance, and manage your chatbot from the agent

Connect BubblaV to Cursor through the BubblaV MCP Server. Ask Cursor's agent to add the chat widget to the site you are building, check your chatbot's performance, teach it new knowledge, and create custom tools for your API. You do not need an API key.

## Why Connect Cursor?

* **Install the widget from your editor**: The agent gets your embed snippet and adds it to your project
* **Build custom tools next to your API**: Create webhook tools for the endpoints you write
* **Close content gaps**: See what your bot could not answer and add the missing answers
* **Analytics on demand**: Get a full report for any date range
* **No API key**: OAuth handles the connection

## Prerequisites

* A BubblaV account. You can create one during the sign-in step
* Cursor with plugin and MCP support

## Connect BubblaV

<Steps>
  <Step title="Install the plugin">
    Open the BubblaV listing on the [Cursor Marketplace](https://cursor.com/marketplace) and select **Add to Cursor**, or search for **BubblaV** in **Customize**. The plugin adds the MCP server and two skills: **add-chat-widget** and **manage-custom-tools**.
  </Step>

  <Step title="Authorize BubblaV">
    The first time the agent calls a BubblaV tool, Cursor opens the BubblaV sign-in page. Sign in, select the website (chatbot) to connect, and approve. If you do not have a website, choose to create a chatbot without one.
  </Step>

  <Step title="Try it">
    Ask the agent *"Add the BubblaV chat widget to this app"* or *"Which questions could my chatbot not answer last week?"*
  </Step>
</Steps>

After you approve, BubblaV creates an API key labeled **Cursor** in your account for the connection.

### Add the MCP server without the plugin

Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json theme={null}
{
  "mcpServers": {
    "bubblav": {
      "url": "https://www.bubblav.com/mcp"
    }
  }
}
```

Cursor detects that the server needs OAuth and shows a **Connect** button for BubblaV in **Customize**.

## What You Can Ask

| Tool | What it does | Example prompt |
| - | - | - |
| `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_get_search_widget_snippet` | Get the code that adds the AI search box | "Add the BubblaV search box to the header" |
| `bubblav_create_custom_tool` | Create a webhook custom tool (Pro+) | "Create a custom tool that calls our /orders/lookup endpoint" |
| `bubblav_list_tool_logs` | Read recent tool calls and their errors | "Why did my order-status tool fail today?" |
| `bubblav_read_report` | Full analytics report for a date range | "How is my chatbot performing this month?" |
| `bubblav_get_content_gaps` | Topics your knowledge base is missing | "What should I add to my knowledge base?" |
| `bubblav_add_knowledge` | Add a knowledge entry | "Add our new API rate limits to the chatbot's knowledge" |
| `bubblav_add_crawl_url` | Add a URL to crawl and index | "Index our new docs page" |
| `bubblav_update_widget_appearance` | Update bot name, greetings, colors, position | "Match the widget color to our brand blue" |

<Info>
  For the full tool reference, see the [MCP Server developer guide](/developer-guide/mcp-server). For ready-to-use prompts, see [AI Agent Workflows](/user-guide/ai-agent-workflows).
</Info>

## Privacy

* One connection gives access to one website (chatbot)
* Conversations and leads can contain your visitors' names, email addresses, and messages. The agent sees this data when a tool returns it
* 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 **Cursor** API key in your BubblaV dashboard. Then connect BubblaV again in **Customize** and pick the website you want during sign-in.

## Troubleshooting

<AccordionGroup>
  <Accordion title="BubblaV shows 'Needs authentication'">
    * Open **Customize**, find BubblaV under MCP servers, and select **Connect**.
  </Accordion>

  <Accordion title="Authorized the wrong website">
    * Revoke the Cursor API key in BubblaV and connect again. Pick the correct website during sign-in.
  </Accordion>

  <Accordion title="The agent does not use BubblaV tools">
    * Make sure the BubblaV server is turned on in **Customize**.
    * Name the task directly, for example *"Use BubblaV to get my widget snippet."*
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={3}>
  <Card title="MCP Server" icon="server" href="/developer-guide/mcp-server">
    Full tool reference and other MCP clients
  </Card>

  <Card title="Custom Tools" icon="wrench" href="/user-guide/integrations/custom-tools">
    Webhook tools you can create from Cursor
  </Card>

  <Card title="Claude" icon="comments" href="/user-guide/integrations/claude">
    Use BubblaV from Claude
  </Card>
</CardGroup>


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