One command, then just ask
npx databull@latest mcp
It creates a read-only key on your own DataBull, checks the connection, adds DataBull to Claude Code if it's installed, and prints the exact config for
Cursor,
Codex,
Windsurf, VS Code and any other MCP client. Prefer clicking? Settings → API keys & AI agents shows the same snippets, filled in.
Questions it answers
- "Which post made me the most money this month?" Referrers, campaigns and pages ranked by revenue, not just visits.
- "What changed compared with last week?" Revenue, visitors and conversion against the previous period, with the sources behind the change.
- "Walk me through my latest buyer's journey." Where they came from, what they read, when they paid.
- "Which channel brings customers worth keeping?" Lifetime value by first source, renewals included.
- "Who's on the site right now?" Live visitors with page, source and location.
Eleven read-only tools
| Tool | What the agent gets |
|---|---|
| list_sites | Every site: today, online now, 7 and 30 days. |
| get_overview | Visitors, revenue, sales, conversion and revenue per visitor, against the previous period, with a time series and traffic spikes. |
| get_breakdown | Any dimension ranked by visitors or revenue: referrer, channel, campaign, page, landing page, country, device, goal. |
| compare_periods | What changed, with the biggest gainers and losers. |
| list_sales | Sales with the source each one is credited to. |
| list_visitors / get_visitor | Who visited, and one person's whole journey. |
| get_realtime, get_goals, get_funnels, get_customer_value | Live visitors, goals, funnel steps, lifetime value by source. |
Your data stays yours
The MCP server runs inside your own DataBull, on your Cloudflare account: the agent talks to your install, not to us. Keys are read-only, stored only as a hash, and revocable any time. Customer names and emails stay hidden unless you create a key that includes them.
Not using an agent? Same data in the terminal
npx databull@latest sources --by revenue
npx databull@latest compare
npx databull@latest sales -n 10 --json
Every command takes --json for scripts, and works on any machine with DATABULL_URL and DATABULL_API_KEY. Details in the AI agents, CLI & API docs.