Query website traffic, events, signup goals, funnels, and errors with scoped Databuddy access.
Connect Remote server
claude mcp add --transport http databuddy https://api.databuddy.cc/v1/mcp --header "x-api-key: <X_API_KEY>"
{
"mcpServers": {
"databuddy": {
"url": "https://api.databuddy.cc/v1/mcp",
"headers": {
"x-api-key": "<X_API_KEY>"
}
}
}
}
{
"servers": {
"databuddy": {
"type": "http",
"url": "https://api.databuddy.cc/v1/mcp",
"headers": {
"x-api-key": "<X_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://api.databuddy.cc/v1/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 35 found in our last check
get_funnel_analytics_by_referrerReturn one funnel's conversion broken down by referrer, by funnelId from list_funnels. Paginated over referrers. Referrers with a single visitor are omitted, so totals can be lower than get_funnel_analytics.
update_goalUpdate a conversion goal. confirmed=false (default) returns the current goal and the changes without writing; confirmed=true applies them.
delete_goalDelete a conversion goal. confirmed=false (default) returns the goal without deleting it; confirmed=true deletes it.
update_annotationUpdate an annotation's text, tags, color, or visibility. confirmed=false (default) returns the changes without writing; confirmed=true applies them.
delete_annotationDelete a chart annotation. confirmed=false (default) returns the annotation without deleting it; confirmed=true deletes it.
update_linkUpdate a short link. confirmed=false (default) returns the current link and the changes without writing; confirmed=true applies them.
delete_linkDelete a short link. confirmed=false (default) returns the link without deleting it; confirmed=true deletes it.
list_websitesList the websites this account can access, with IDs, names, domains, and organizations. Website-scoped tools accept websiteId, websiteName, or websiteDomain.
list_insightsList published insights for an organization or website: title, summary, evidence, impact, and the recorded next step (null when no step was recorded, when a later finding for the same case superseded it, or when the case resolved).
list_investigationsList the latest investigation per subject with IDs. state is needs_you, watching or resolved; need says what the team owes. Cases with dashboard work queued or running are left out until it finishes; get_investigation reads one by ID.
get_investigationGet one durable investigation, including its current status, evidence-backed observations, and replies. A skipped reply ran no work; skipReason says why. The ID may come from Slack or list_investigations.
reply_to_investigationAdd a clarification to an existing investigation. It is answered from the case's saved evidence, without new measurements or actions. The answer appears in get_investigation. It cannot start a new investigation.
dismiss_investigationClose an open investigation with the team's reason, only when the user asks. Future investigations read the note. expected, wrong and not_useful keep the subject quiet for 30 days unless it gets materially worse.
get_dataQuery Databuddy's analytics API (www.databuddy.cc/docs/api) for a website: one query or a batch of 2-10. Query types come from capabilities. Default range last_30d. Returns at most 20 rows per query.
get_schemaReturn the analytics tables with column names and types as a reference.
capabilitiesReturn get_data query types, date presets, categories, and a schema summary. 'include' selects sections; queryTypes are omitted unless requested or filtered by category or contains.
list_funnelsList funnels for a website with their steps and filters. Funnel IDs are used by get_funnel_analytics.
get_funnel_analyticsReturn per-step conversion and drop-off for one funnel, by funnelId from list_funnels. Visitors entering in range get conversionWindowHours to finish, even past range end. time_series holds at most the latest 90 points.
create_funnelCreate a funnel for a website. confirmed=false (default) returns a preview without writing; confirmed=true creates it.
list_goalsList conversion goals for a website with their type, target, and filters. Goal IDs are used by get_goal_analytics.
search_replaysFind recordings by email, profileId, current user traits, recording dates, pages, timeline text, events, activity, or watch score. Use known trait values; ask if unknown. Dates refer to visits. Returns watch links, newest first.
get_goal_analyticsReturn entered and completed counts and the conversion rate for one goal, by goalId from list_goals.
create_goalCreate a conversion goal. confirmed=false (default) returns a preview without writing; confirmed=true creates it.
list_link_foldersList short-link folders for the website's organization, with link counts. Links can only be assigned to these existing folders.
list_linksList short links for the website's organization, newest first, with existing folders. total covers the full catalog; search_links finds a specific link.
search_linksFind short links across the full catalog matching a substring on name, slug, target URL, or external ID, newest first.
create_linkCreate a short link in the website's organization. confirmed=false (default) returns a preview without writing; confirmed=true creates it.
list_annotationsList chart annotations for a website: text, time range, tags, color, and visibility.
create_annotationCreate a chart annotation. confirmed=false (default) returns a preview without writing; confirmed=true creates it.
list_flagsList feature flags with their status, rollout, rules, and variants: a website's flags when a website is given, otherwise the organization-wide flags. Flag IDs are used by update_flag and add_users_to_flag.
get_experiment_resultsCompare goal conversion across flag variants for tracked evaluations. Uses two-sided Fisher when any expected cell is below 5, otherwise a two-proportion z-test. Mixed visitors are excluded; minimumVisitorsPerArm still gates significance.
create_flagCreate a feature flag, inactive and boolean unless configured. confirmed=false (default) returns a preview without writing; confirmed=true creates it.
update_flagUpdate a flag's config, status, rollout, rules, or variants. rules replaces every rule and needs expectedUpdatedAt. confirmed=false (default) previews the current flag with full rules and updatedAt; confirmed=true applies.
add_users_to_flagTarget user IDs or emails on a feature flag. mode=append (default) adds one rule; mode=replace deletes every existing rule first. confirmed=false (default) previews.
submit_feedbackSend a bug report, feature request, or blocking error about Databuddy itself to the Databuddy team. Call only after the user asks or agrees to send it. Problems on the user's own website are analytics questions.
Headers
| Name | Description |
|---|---|
x-api-keyOptional, secret | For clients without OAuth sign-in, create a Databuddy API key with read:data access. Omit this header for OAuth. |
Details
| Endpoint | https://api.databuddy.cc/v1/mcp (Streamable HTTP) |
| First published | 10 Nov 2026 |
| Last updated | 10 Nov 2026 |
| Registry name | io.github.databuddy-analytics/databuddy |
More data and analytics servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
