# askbowtie

> Every signal a website emits (analytics, JS errors, conversions, Google Search Console, Google Ads, uptime) joined into one MCP server an AI agent can query. Ask in plain language, get answers with every number cited. No dashboards.

askbowtie is built for website owners, vibecoders, and agencies who work with AI agents
(Claude Code, Codex, Cursor, Claude Desktop, or anything that speaks MCP). One lightweight
tracker plus connected Google sources feed one per-site database; answers are joined across
silos at read time (ads ⋈ analytics ⋈ search ⋈ errors ⋈ uptime). "Bowtie" is the persona you
address; the ⋈ mark is the relational-algebra bowtie (join) operator.

Key facts:
- Primary interface: an MCP server your agent connects to once. 39 tools cover traffic,
  conversions, incidents, alerts, performance, crawl, search, ads, flows, page roles,
  section engagement, page-level detail, and cross-silo joins.
- Human path: email digests and down/up alerts. No dashboard required, by design.
- Data: first-party only, stored per site in its own database, exportable, never sold or shared.
- Tracker: one small async script; never blocks rendering.
- Multi-site: each site gets its own tracker and database under one connection.

## Pricing

You pay when Bowtie thinks for you (AI answers), or when your traffic gets big (events beyond
the free tier). Everything else is free.

- Free: the tracker, dashboard, and MCP — for normal use, up to ~100,000 events/month across
  all your sites. Query it freely, including from your own AI agent; the MCP is not metered.
- Credits ($10 = 1,000): AI answers (the in-app Ask tab, rolling out) and traffic past the free
  tier. A typical question costs a few credits; credits never expire. Early users get a free stack.

Fit: free for light or personal use; credits scale for power users and agencies running many
sites. No subscription, no surprise bills.

## Pages

- [Home](https://askbowtie.com/): Ask Bowtie about your site — interactive demo, features, FAQ
- [Features](https://askbowtie.com/#features): the six signals, the join, MCP server, email digest
- [FAQ](https://askbowtie.com/#faq): data collected, tracker weight, MCP setup, supported agents, privacy, pricing
- [Pricing](https://askbowtie.com/pricing/): free tier (tracker + dashboard + un-metered MCP, up to ~100k events/mo) vs pay-as-you-go credits ($10 = 1,000, for AI answers + overflow traffic, never expire); markdown twin: [index.md](https://askbowtie.com/pricing/index.md)
- [Get started](https://askbowtie.com/signup/): 3-step onboarding — add the tracker, connect Google sources, connect the MCP; passwordless (magic-link or Google) sign-in; markdown twin: [index.md](https://askbowtie.com/signup/index.md)
- [About](https://askbowtie.com/about-us/): what askbowtie is, the "agent is the brain / no alerting brains" philosophy, the itbroke.dev rebrand; markdown twin: [index.md](https://askbowtie.com/about-us/index.md)

## Docs

- [Docs](https://askbowtie.com/docs/): tracking reference — install, auto-tracked events, custom events, conversions with revenue, errors, guardrails, server-side events, MCP setup
- [events.md](https://askbowtie.com/docs/events.md): the same reference in plain markdown, written for agents
- [Server-side events](https://askbowtie.com/docs/events.md#server-side-events-no-browser): send conversions/events from a backend or Cloudflare Worker (webhook-confirmed conversions, ad-block-proof leads) by POSTing to `/api/ingest`. Every event MUST set `"source":"server"` or it is silently dropped (the bot filter) or mis-tagged as a browser event; verify each batch with the response's `stored` field (`stored.server`), never `events_received`.
- [Plans & limits](https://askbowtie.com/docs/pricing/): what's free, exactly what counts as an event, the un-metered MCP, when credits apply, platform rate limits; markdown twin: [index.md](https://askbowtie.com/docs/pricing/index.md)
- [Credits](https://askbowtie.com/docs/credits/): what a credit is ($10 = 1,000), what consumes them (AI answers + overflow traffic; MCP self-queries are free), balance, never expire; markdown twin: [index.md](https://askbowtie.com/docs/credits/index.md)

## Guides

First-person walkthroughs of using askbowtie on a live site.

- [How I Ran an AI Content Audit on My Own Site](https://askbowtie.com/guides/ai-content-audit/): pointed an AI agent at my own Search Console + analytics; it graded all 27 pages (kill/combine/rewrite) in one sitting; markdown twin: [index.md](https://askbowtie.com/guides/ai-content-audit/index.md)
- [How I Find a Silently Broken Form With AI](https://askbowtie.com/guides/find-broken-forms/): join rage clicks to conversion drops to pinpoint a dead form element and the deploy that broke it; markdown twin: [index.md](https://askbowtie.com/guides/find-broken-forms/index.md)
- [How I Diagnose a Sudden Conversion Drop](https://askbowtie.com/guides/diagnose-conversion-drops/): one question joins traffic, conversions, errors, and Search Console into a fast diagnosis; markdown twin: [index.md](https://askbowtie.com/guides/diagnose-conversion-drops/index.md)
- [How I Give My AI Agent Memory Between Sessions](https://askbowtie.com/guides/ai-agent-memory/): askbowtie notes as per-project, cross-project agent memory; markdown twin: [index.md](https://askbowtie.com/guides/ai-agent-memory/index.md)

## Learn

Practical guides on the things that quietly cost websites money: errors nobody reports, funnels
that leak, pages that got slow. Every guide has a plain-markdown twin at its URL + `index.md`,
written for agents.

- [Learn index](https://askbowtie.com/learn/): the full catalog of guides, grouped by topic; markdown twin: [index.md](https://askbowtie.com/learn/index.md)
- [MCP for your website (hub)](https://askbowtie.com/learn/mcp/): what Model Context Protocol is, which servers matter, and how to point an AI agent at your live site; markdown twin: [index.md](https://askbowtie.com/learn/mcp/index.md)
- [What is Model Context Protocol?](https://askbowtie.com/learn/mcp/what-is-model-context-protocol/): plain explanation of MCP, the open standard that lets an AI agent connect to real tools and data; markdown twin: [index.md](https://askbowtie.com/learn/mcp/what-is-model-context-protocol/index.md)
- [The best MCP servers for your website](https://askbowtie.com/learn/mcp/best-mcp-servers-for-your-website/): honest rundown of MCP servers for code and for your live site (GitHub, Sentry, Playwright, Figma, Context7, Google Analytics MCP, askbowtie), including where each stops; markdown twin: [index.md](https://askbowtie.com/learn/mcp/best-mcp-servers-for-your-website/index.md)
- [Connect your site to Claude](https://askbowtie.com/learn/mcp/connect-your-site-to-claude/): the short walkthrough to connect your website to Claude over MCP so your agent answers questions about your real traffic, errors, and conversions; markdown twin: [index.md](https://askbowtie.com/learn/mcp/connect-your-site-to-claude/index.md)
- [The analytics your AI agent can read](https://askbowtie.com/learn/mcp/analytics-your-ai-agent-can-read/): why an MCP that serves joined, queryable site data beats a dashboard when your agent is the one asking; markdown twin: [index.md](https://askbowtie.com/learn/mcp/analytics-your-ai-agent-can-read/index.md)

### Analytics

- [Section Engagement Analytics](https://askbowtie.com/learn/new-analytics/): tag pages by role (`data-askbowtie-tag`) and page sections by engagement (`data-askbowtie-section`); measure which parts of a page get clicked and which drive conversions; classify existing clicks retroactively with rules, no code changes. Includes the full MCP tool reference (get_page_types, tag_pages, get_engagement, manage_sections); markdown twin: [index.md](https://askbowtie.com/learn/new-analytics/index.md)

### Error monitoring

- [Error monitoring — the full guide](https://askbowtie.com/learn/error-monitoring/): catch JavaScript errors, broken elements, and silent failures before they cost conversions; connects bugs to revenue; markdown twin: [index.md](https://askbowtie.com/learn/error-monitoring/index.md)
- [User Behavior Signals That Predict Conversion Problems](https://askbowtie.com/learn/error-monitoring/user-behavior/): the behavior signals (beyond technical errors) that turn error monitoring into conversion protection; markdown twin: [index.md](https://askbowtie.com/learn/error-monitoring/user-behavior/index.md)
- [Prioritizing Errors by Revenue Impact](https://askbowtie.com/learn/error-monitoring/prioritizing-errors/): a framework for deciding which JavaScript errors to fix first based on business impact, not frequency; markdown twin: [index.md](https://askbowtie.com/learn/error-monitoring/prioritizing-errors/index.md)

### Conversions

- [Conversions — the full guide](https://askbowtie.com/learn/conversions/): how to track conversions, build funnels, and find exactly where users drop off; markdown twin: [index.md](https://askbowtie.com/learn/conversions/index.md)

### Performance

- [Performance — the full guide](https://askbowtie.com/learn/performance/): monitor site speed, Core Web Vitals, and uptime in one place; know when your site is slow or down before your visitors do; markdown twin: [index.md](https://askbowtie.com/learn/performance/index.md)

### Fixes

- [Fixes — the full guide](https://askbowtie.com/learn/fixes/): fix broken forms, checkout failures, plugin conflicts, and slow pages; platform-specific solutions for WordPress, Shopify, and general web issues; markdown twin: [index.md](https://askbowtie.com/learn/fixes/index.md)
- [Common WordPress Problems and How to Fix Them](https://askbowtie.com/learn/fixes/wordpress-fixes/): step-by-step fixes for broken forms, plugin conflicts, slow pages, and email delivery failures on WordPress; markdown twin: [index.md](https://askbowtie.com/learn/fixes/wordpress-fixes/index.md)
- [Why Your WordPress Form Isn't Sending Emails](https://askbowtie.com/learn/fixes/wordpress-forms/): submissions appear to work but emails never arrive; why it happens and how to fix it in under 10 minutes; markdown twin: [index.md](https://askbowtie.com/learn/fixes/wordpress-forms/index.md)
- [Why Your Form Isn't Working: Diagnose Submission Failures](https://askbowtie.com/learn/fixes/form-failures/): diagnose and fix forms that don't submit, data that disappears, and confirmations that never arrive; markdown twin: [index.md](https://askbowtie.com/learn/fixes/form-failures/index.md)
- [Form Stuck Loading After Submit](https://askbowtie.com/learn/fixes/form-stuck-loading/): endless loading after submit is usually one of three things; how to tell whether it's frontend, server, or network; markdown twin: [index.md](https://askbowtie.com/learn/fixes/form-stuck-loading/index.md)
- [How to Fix Payment Gateway Errors on Your Website](https://askbowtie.com/learn/fixes/payment-gateway-errors/): diagnose common payment gateway errors and fix them before they cost more revenue; markdown twin: [index.md](https://askbowtie.com/learn/fixes/payment-gateway-errors/index.md)
- [Diagnosing WordPress Plugin Conflicts](https://askbowtie.com/learn/fixes/plugin-conflicts/): a systematic approach to finding which plugin is breaking your site, without guessing; markdown twin: [index.md](https://askbowtie.com/learn/fixes/plugin-conflicts/index.md)
- [Shopify Checkout Not Working](https://askbowtie.com/learn/fixes/shopify-checkout-broken/): when customers can't complete checkout on Shopify it's usually your theme, an app, or Shopify itself; how to diagnose and fix it quickly; markdown twin: [index.md](https://askbowtie.com/learn/fixes/shopify-checkout-broken/index.md)
- [Shopify Checkout Problems: Diagnosis and Fixes](https://askbowtie.com/learn/fixes/shopify-issues/): diagnose checkout failures, app conflicts, and theme issues on Shopify, with step-by-step fixes; markdown twin: [index.md](https://askbowtie.com/learn/fixes/shopify-issues/index.md)

### The tracker

- [How askbowtie Works](https://askbowtie.com/learn/tracker/how-it-works/): what the tracker script does, what data it collects and doesn't, and how it keeps your site fast and visitors' data private; markdown twin: [index.md](https://askbowtie.com/learn/tracker/how-it-works/index.md)
- [Installing the askbowtie Tracker](https://askbowtie.com/docs/install/): add the tracking script to any website (WordPress, Shopify, Next.js, plain HTML); one script tag, a 9.8 KB loader, no cookies; markdown twin: [index.md](https://askbowtie.com/docs/install/index.md)
- [Server-side sessions](https://askbowtie.com/docs/server-side/): the ADVANCED setup, and the fix for a conversion rate above 100% or missing per-source attribution; post the page view AND the conversion from your backend under one id you own, so the join is exact; markdown twin: [index.md](https://askbowtie.com/docs/server-side/index.md)
- [JavaScript API](https://askbowtie.com/learn/tracker/javascript-api/): report conversions, errors, and custom events directly from your code with the askbowtie JavaScript API; markdown twin: [index.md](https://askbowtie.com/learn/tracker/javascript-api/index.md)
- [Cookieless Tracking](https://askbowtie.com/learn/tracker/cookieless-tracking/): how askbowtie tracks sessions without cookies, and how to keep it that way when adding server-side conversions, payment webhooks, or custom integrations; markdown twin: [index.md](https://askbowtie.com/learn/tracker/cookieless-tracking/index.md)
- [Security & Data](https://askbowtie.com/learn/tracker/security-and-csp/): how askbowtie handles your data — what's public, what's authenticated, how sites are isolated, and the CSP directives to allow the tracker; markdown twin: [index.md](https://askbowtie.com/learn/tracker/security-and-csp/index.md)

## Full detail

- [llms-full.txt](https://askbowtie.com/llms-full.txt): complete product description, MCP tool list, and FAQ text

- [Playbook directory](https://askbowtie.com/playbooks/): all 19 indexed agent procedures (investigate, set up, watch, site health, paid) with when-to-use and how to run each over the MCP.