MCP Server
MCP prompts and resources
Start a guided task with a prompt, and know which reference guides the server gives your AI app.
Prompts
A prompt is a ready set of instructions that your AI app follows step by step. In most apps you pick it from the prompt or slash-command menu. You can also describe the task in your own words, and the app finds the tools.
Prompts take no arguments. The app asks you for what it needs, for example the data app or the client ID.
| Prompt | What it does |
|---|---|
embed-existing-dashboard | Embed a dashboard you already built: pick the data app, make sure it has an API token, pick the dashboard, create the embed |
embed-blank-dashboard | Give each client their own dashboard with create_embed and a clientId |
brand-my-embed | Change colors, fonts, chart styles and card styling to match your brand |
query-data | Ask questions in plain words, get rows and a chart, and improve the semantic layer |
populate-semantic-layer | Generate table and column descriptions for a datamart, so plain-word questions work better |
customize-customer-dashboard | Add, change or remove widgets on one client’s dashboard. Other clients do not change |
sql-to-metric-migration | Turn tested SQL into a metric on a client dashboard: check, dry run, then apply with APPLY_TO_PRODUCTION |
sql-to-workspace-metric | Turn tested SQL into an unpublished workspace metric, with no client ID: check, dry run, then apply |
A prompt does not give the app any extra access. Each tool it calls still needs your role and, on the hosted connector, the access you approved.
Resources
The server also gives your AI app these reference guides. The app reads them when it needs a fact, for example a web component attribute.
| Resource | What it holds |
|---|---|
databrain://getting-started | The object model, an onboarding checklist and common mistakes |
databrain://api-reference | A summary of the main API endpoints |
databrain://embedding-guide | Embed code for React, Next.js, Vue, Angular, Svelte, SolidJS and plain JavaScript |
databrain://filter-reference | Filter types and operators for guest tokens, runtime and dashboard filters |
databrain://theme-reference | Theme properties and preset themes |
databrain://web-component-reference | Every property of dbn-dashboard and dbn-metric |
databrain://self-serve-reference | Access settings, metric creation modes and runtime permission overrides |
databrain://semantic-layer-guide | Semantic layer setup for plain-word questions |
databrain://multi-tenancy-guide | Row-level security with clientId and the client column |
databrain://use-case-guides | The three main use cases, with tool order and prompt names |
databrain://permission-schema | Embed access settings, guest token permissions and which one wins |
Apps that show MCP Apps also get two tile views, ui://databrain/chart-tile and ui://databrain/kpi-tile. They draw the chart and KPI results inside the chat.
See the tools reference for what each tool does.