AskBadge Docs

1. Create an account and add your site from the dashboard.

2. Verify your domain (DNS TXT record or meta tag — takes 30 seconds).

3. Copy your embed code and paste it before the closing </body> tag.

That's it. The widget is live.

Add this single script tag to your site. Replace YOUR_SITE_KEY with your site's key from the dashboard:

<!-- AskBadge Widget -->
<script
  src="https://askbadge.com/widget.js"
  data-key="YOUR_SITE_KEY"
  async
></script>

The async attribute means it won't block page rendering. The script is ~8KB gzipped.

Your site must be verified before the widget renders. Unverified sites return 404 from the widget API, and the script exits silently.

Verification proves you own the domain. Choose either method:

Type:    TXT
Name:    @ (or your domain)
Value:   askbadge-verify=YOUR_TOKEN

<meta name="askbadge-verify" content="YOUR_TOKEN" />

Your verification token is shown on the site's verification page in the dashboard. Click "Check verification" after adding the record/tag.

AskBadge supports five AI platforms. Each click opens the platform in a new tab with your prompt.

Gemini doesn't support URL-based prompts — clicking Gemini copies your prompt to clipboard and opens gemini.google.com. The widget shows a "Prompt copied!" tooltip.

Use these variables in your custom prompt. They're replaced at runtime with your site's actual values:

Default prompt if none set:

Tell me about {siteUrl}. What does it do, who is it for, and would you recommend it?

Agency API keys also work with the AskBadge MCP server, so Claude Desktop, Cursor, and other MCP clients can read your sites, analytics, loop data, and widget config directly.

The MCP package is read-only and runs locally over stdio. It does not create sites or complete checkout and verification flows for you.

Setup instructions, config snippets, and the full tool list live in /docs/api.

{
  "mcpServers": {
    "askbadge": {
      "command": "npx",
      "args": ["-y", "askbadge-mcp"],
      "env": {
        "ASKBADGE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

API access is available on the Agency plan.

Full Agency API documentation lives at /docs/api.