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.
Step by step: DataBull in Claude Code · DataBull in
Cursor · What to ask
Claude about your analytics.
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.
Fourteen 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. |
| get_peak_hours, get_engagement, get_purchase_paths | When visitors come and buyers pay, how far each page is read, and how customers got to their first purchase. |
Your data stays yours
The MCP server runs inside your own DataBull: on your Cloudflare account when self-hosted, or in your own dashboard on ours with Hosted (beta). The agent talks to your dashboard directly. 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.