Skip to content
databrushDocs
  • OverviewDatabrush’s churn and retention analysis for your Supabase database, in the app and over MCP.
  • QuickstartConnect Supabase, choose your database and confirm the setup to publish your first analysis.
  • Supabase integrationHow Databrush connects to Supabase, what it reads and keeps, and how to revoke its access.
  • Connect your agentConnect Databrush to Claude, Claude Code, ChatGPT, Codex or another agent over MCP.
  • Tool referenceEvery tool Databrush’s MCP server offers, what it does, and who can use it.
  • How it worksHow Databrush analyzes your data, what Home shows, and how sure each finding is.
  • DefinitionsCustomers, who is left out, actions, churn and the dormant window, and how to change them.
  • Security & dataHow Databrush protects your database, your customers’ details and your account.
Connect Supabase
Tool reference

Connect

Tool reference

Databrush’s MCP server offers 39 tools: the same views and decisions as the Databrush app. Your agent acts as you, with your role in the workspace. Connect your agent first.

On this page

Read-only and Preview tools change nothing. Change tools record a decision in Databrush, never in your database, as the user who connected the agent.

Workspaces and setup

Set up a workspace for a Supabase database, from choosing the database to the first analysis.

ToolWhat it doesKindWho
list_workspacesList workspacesThe workspaces your agent can open, and whether each is set up.Read-onlyEveryone
list_databasesList databases to set upThe Supabase databases Databrush can read for you, or the link to choose a plan or approve Supabase first.Read-onlyOwners and admins
create_workspaceCreate a workspaceCreates a workspace for a database and starts reading it, read-only, into a setup proposal.ChangeOwners and admins
get_setupGet the setup proposalThe proposed customers, actions and churn definition, once the database has been read.Read-onlyOwners and admins
retry_setupRetry reading the database for setupReads the database again when setup stopped, optionally with fewer schemas.ChangeOwners and admins
confirm_setupConfirm workspace setupConfirms the setup, with any changes, and runs the first analysis.ChangeOwners and admins

Definitions

Read and change the definitions every number follows. Preview a change before saving it.

ToolWhat it doesKindWho
get_definitionsGet workspace definitionsThe confirmed definitions every number follows: customers, who is left out, actions, activity and churn.Read-onlyEveryone
get_data_coverageGet data coverageWhich tables Databrush reads from the database, and what it never reads.Read-onlyEveryone
preview_churn_definitionPreview a churn definition changeShows which customers would change status under a new churn definition. Changes nothing.PreviewEveryone
update_churn_definitionChange the churn definitionSaves a new churn definition, or who is left out. Churn is recalculated and Retention Signals start over.ChangeOwners and admins
preview_actions_changePreview a product actions changeShows whether an edit to the product actions changes what counts as activity. Changes nothing.PreviewEveryone
update_actionsChange the product actionsSaves the product actions. A change to what counts as activity is saved with the churn definition instead.ChangeOwners and admins
set_dormant_windowSet the dormant windowSets how many days without activity make a paying customer dormant.ChangeOwners and admins

Home and customers

What Home shows: the overview, decisions waiting, customers needing attention and each customer’s record.

ToolWhat it doesKindWho
get_overviewGet workspace overviewThe top of Home: churn rate, active and dormant customers, and the Overview chart.Read-onlyEveryone
get_metric_seriesGet metric seriesOne standard metric over time, from the last published analysis.Read-onlyEveryone
list_waitingList decisions waiting for youHome’s Waiting for you: suggestions to review, new actions, proposed exclusions and re-confirmations.Read-onlyEveryone
list_attentionList customers needing attentionCustomers likely to churn, with why, their warnings and whether they were contacted.Read-onlyEveryone
get_customerGet customerOne customer’s record: status and the reason for it, warnings, first-week behavior and history.Read-onlyEveryone
get_customer_activityGet customer activityA customer’s daily activity from the confirmed actions, with status changes marked.Read-onlyEveryone
export_contactsExport customers with contact detailsA link, valid for 10 minutes, to a CSV of customers needing attention with names and emails. Needs contact details turned on.Read-onlyEveryone

Follow-up

Record what you did about a customer or a card on Home.

ToolWhat it doesKindWho
mark_contactedMark a customer contactedMarks a customer as contacted, as the button in the app does.ChangeEveryone
unmark_contactedUndo a customer’s contacted markUndoes Mark contacted.ChangeEveryone
dismiss_warningDismiss or snooze a warningDismisses a warning with a reason, or snoozes it for 7 or 30 days.ChangeEveryone
restore_warningRestore a warningBrings back a dismissed or snoozed warning.ChangeEveryone
resolve_new_actionKeep or remove a new actionAnswers a New action detected card: keep counting it, or stop.ChangeOwners and admins
dismiss_exclusion_proposalDismiss an exclusion proposalAnswers Not now to a proposed exclusion.ChangeOwners and admins

Retention Signals

Retention Signals are behaviors in customers’ first week that are linked to staying.

ToolWhat it doesKindWho
list_signalsList Retention SignalsBehaviors in customers’ first week linked to retention, with the statistics behind them.Read-onlyEveryone
preview_signalPreview a Retention SignalChecks a signal before adding it: whether it can be added and how many customers do it. Changes nothing.PreviewEveryone
add_signalAdd a Retention SignalAdds a signal to test, judged on customers who join after you add it.ChangeOwners and admins
remove_signalRemove a Retention SignalRemoves one of your signals.ChangeOwners and admins
search_nowSearch for new Retention Signals nowSearches every action for new signals now, instead of waiting for the next search.ChangeOwners and admins

Product suggestions

Product suggestions, from drafted to shipped and measured.

ToolWhat it doesKindWho
list_suggestionsList product suggestionsEvery open product suggestion, with its status, strength and what it could gain.Read-onlyEveryone
get_suggestionGet product suggestionOne suggestion: why, the evidence, how sure it is and the change to make.Read-onlyEveryone
accept_suggestionAccept a product suggestionAccepts a drafted suggestion.ChangeOwners and admins
suggestion_not_nowDefer a product suggestionSets a suggestion aside for now.ChangeOwners and admins
edit_suggestion_textEdit a product suggestion’s changeRewrites the change a suggestion proposes.ChangeOwners and admins
dismiss_suggestionDismiss a product suggestionDismisses a suggestion, with an optional reason.ChangeOwners and admins
preview_shipPreview a suggestion’s ship planShows how Databrush would measure a suggestion shipped on a given day. Changes nothing.PreviewEveryone
mark_suggestion_shippedMark a suggestion shippedMarks an accepted suggestion as shipped on the day it went live, which fixes how it will be measured. Your agent does this itself once a change it built is live for every customer.ChangeOwners and admins

Questions? Email support@databrush.ai.