Databuddy MCP
Apps & Automationdatabuddy-mcpDatabuddy MCP is an Agent Skill for apps & automation published in the databuddy-analytics/Databuddy repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use whenever the Databuddy MCP server is available and the user wants their analytics, errors, vitals, insights, comparisons, anomalies, top movers, flags, links, or annotations queried. Covers get_data, ask, capabilities, summarize_insights, compare_metric, top_movers, detect_anomalies, get_schema, list/save/forget memory, and workspace mutations. Not for SDK integration help (use databuddy) or monorepo implementation (use databuddy-internal).
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/databuddy-analytics/Databuddy/blob/HEAD/.agents/skills/databuddy-mcp/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/databuddy-mcp, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Databuddy MCP
The MCP server ships its own session-start instructions and a databuddy://guide resource — those are the canonical reference. This skill exists so Claude Code surfaces the routing context up front instead of waiting for the MCP initialize flow.
Quick routing
- Known shape (top pages, recent errors, summary metrics) →
get_data. Batch 2-10 withqueries[]. - "What changed", anomalies, top movers, compare last week →
summarize_insights/compare_metric/top_movers/detect_anomalies(faster and cheaper thanask). - Open-ended question →
ask. ReuseconversationId. - Discovery →
capabilities(catalog) orget_schema(columns).
Conventions
- Website: pass
websiteId,websiteName, orwebsiteDomain— any one works. - Dates: a
presetOR bothfrom+to(YYYY-MM-DD). Defaults tolast_7d. Don't pass only one offrom/to. - Filters:
fieldis the ClickHouse column name. Errors list allowed fields and suggest matches on typos. - Mutations (flags, links, folders, memory): preview with
confirmed=false, get user approval, thenconfirmed=true.
For more depth
Fetch the databuddy://guide MCP resource. That's the single source of truth — including the error-table footguns (message vs error_type) and the custom-events filter shape.