Docs

Set up in four steps, then run the widget on any site.

Getting started

You can go from a blank site to a working chat widget in four steps. No developer, no plugins.

1. Sign in

Open the dashboard at chatterbox.cbrspn.cloud and sign in with Google. Your account, and every tenant you manage, lives there.

2. Add your knowledge

Chatterbox turns each source you give it into question-and-answer “facts” the bot answers from. Add your content four ways:

  • Crawl a website URL. Point us at your site. Turn on the option to follow linked pages on the same site when you want more than the one page.
  • Upload a file. Bring a document you already have.
  • Paste text. Drop in copy straight from your notes.
  • Type Q&A pairs. Write the exact question and the exact answer yourself.

3. Copy your install snippet

Open the Install page and copy the one <script> line. It carries your public key. Paste it right before </body> on your site and save.

4. You’re live

The widget now answers your visitors from your content and shows them the source it used. When it can’t answer, it asks for a phone number so you don’t lose the lead.

What’s supported

Knowledge sources

Feed the bot from a website crawl, a file upload, pasted text, or manual Q&A. The page count per crawl depends on your plan. Re-crawl a source once a day to refresh it after you change your site.

Crawl failing or returning nothing? Check your site’s robots.txt and allow ChatterboxBot. Our crawler obeys robots.txt, so a rule that disallows it — including a blanket User-agent: * block — stops the crawl before it starts. Adding this is enough:

User-agent: ChatterboxBot
Allow: /

Predictable answers

Every answer traces back to a passage in your content, and the widget shows visitors which source it came from. When the bot is unsure, it asks for the visitor’s number instead of guessing.

Languages

The bot replies in the visitor’s language. English, Hindi, and Hinglish work out of the box. Paid plans add knowledge-base translation into more languages.

Lead capture

The widget collects name, phone, and email. Leads land in your dashboard and in your inbox. Once a visitor shares their details, the chat shows a confirmation and closes.

The widget

One script tag, under 15KB, runs on any site, including cheap shared hosting. It carries a small “Powered by Chatterbox” credit. Paid white-label plans remove it.

Plans

Chatterbox comes in three plans: Free, Starter, and Pro. Free covers a small crawl and English. Paid plans unlock deeper crawls, more languages, and branding removal. See Pricing for what each plan includes and the current prices.

Monthly answer limit

Each plan includes a monthly allowance of answered questions. When you reach it, the widget keeps capturing leads until your monthly allowance resets or you upgrade. Some plans run unlimited. See Pricingfor each plan’s allowance.

Connect an AI tool (MCP)

An MCP (Model Context Protocol) server lets your own AI tools — Claude Desktop, Cursor, and similar — read and manage your knowledge base and leads by chatting with them directly, instead of going through the dashboard UI.

This is a power-user feature, the same category as GitHub’s, Linear’s, or Notion’s own MCP servers: there’s no guided wizard, just a personal access token you drop into your tool’s JSON config.

Get a token

Sign in to the dashboard, open the User menu from your avatar in the top right, choose MCP Tokens, and generate one.

Treat the token like a password.It gives the connected tool read access to your account’s lead and conversation data, including customer contact details, and that data will be sent to whichever AI service the tool uses.

Configure your client

Chatterbox’s MCP endpoint speaks JSON-RPC 2.0 over HTTP and authenticates with a bearer token. Add it to your client’s config, using your own token in place of the placeholder below:

{
  "mcpServers": {
    "chatterbox": {
      "url": "https://chatterbox.cbrspn.cloud/api/v1/mcp/",
      "headers": {
        "Authorization": "Bearer mcp_live_your_token_here"
      }
    }
  }
}

What the token can do

A token mirrors whatever you can already do in the dashboard, scoped to your own account: read and manage knowledge Q&A pairs, list knowledge sources, list and update leads (status only), and list and read conversations.

Every plan, Free through Agency, includes MCP access, unlimited and at no extra cost. See Pricing for what each plan includes.

Connect an AI agent

The section above is for a person wiring up their own tool. This one is for an agent that found this site by itself and needs to know what it can talk to.

  • MCP endpoint. POST /api/v1/mcp/— JSON-RPC 2.0, protocol revision 2025-06-18, POST only (a GET returns 405). Authenticate with Authorization: Bearer mcp_live_….
  • Getting a token. Only a signed-in human can mint one, from MCP Tokens in the dashboard. It is shown once. An agent should ask its user to do this rather than trying itself.
  • Server card. /.well-known/mcp.json — transport, capabilities and auth, machine-readable. Also at /.well-known/mcp/server-card.json.
  • Skills. /.well-known/agent-skills/index.json — step-by-step instructions for installing the widget, connecting an MCP client, and managing a knowledge base.
  • API catalog. /.well-known/api-catalog — every API on this site, as an RFC 9727 linkset.
  • Markdown of any page. Append .md to its path (/pricing.md; the home page is /index.md), or send Accept: text/markdownto the page’s normal URL.

Ordering extra

More crawl pages

When your plan’s per-crawl page cap runs short, add pages in 10-page blocks from the dashboard. Blocks stack, so buy as many as you need. The current rate is ₹500 per 10-page block. See Pricing for the rate.

More languages or features

Upgrade from Free to Starter or Pro in the dashboard to unlock extra languages, deeper crawls, and branding removal. See Pricing to compare plans.

Getting help

Email us at [email protected]and we’ll help. For account and billing, sign in to the dashboard. For plan questions, check Pricing.

Ready to start? Sign in or read the plans and prices.