Skip to main content
You’ll need a Databrain account, Node.js 18+, and an MCP-compatible AI client. A service token is recommended because it unlocks the full setup flow.

​
Prerequisites

  • Node.js 18+ - check with node --version
  • A Databrain account - sign up here if you don’t have one
  • An AI client - Codex, Cursor, Claude Desktop, Claude Code, Windsurf, or another MCP-compatible client
  • A Databrain credential - preferably DATABRAIN_SERVICE_TOKEN
1

Get Your Service Token

  1. Log in to Databrain
  2. Go to Settings -> Service Tokens
  3. Create a new token and copy it
Keep your service token secure. It provides org-level access to Databrain resources.
2

Add to Your AI Client

Add the MCP server configuration to your client. Pick your client below:
Add the MCP server with your service token:
Verify the server is configured:
Start a new Codex session after adding the server.
For detailed per-client instructions, API-token-only mode, restart steps, and self-hosted configuration, see the Client Setup Guide.
3

Verify the Connection

Open your AI assistant and ask:
“Who am I authenticated as in Databrain?”
This calls whoami and confirms whether the MCP server is running with a service token or API token.Then ask:
“List my Databrain data apps”
If everything is configured correctly, you’ll see your available data apps.
If you see a configuration error saying that no token is set, double-check that the token is in the env block of your MCP config and restart your AI client. See Troubleshooting for more help.
4

Try It Out

Now try a real task:
“Set up a Databrain embed for my dashboard”
The assistant walks you through each step interactively: picking your data app, selecting a workspace and dashboard, creating or reusing an embed, generating a guest token, and generating frontend code.Other things to try:
“Add a widget to a customer’s dashboard”
“List tenants for my workspace so I can pick the right clientId”
“Dry-run creating this SQL query as a Databrain metric”
“Enable self-serve metric creation on this embed”
“Brand my embed to match our company colors”
That’s it. The assistant handles the Databrain API so you can focus on building.

​
Credential Modes

If both tokens are configured, the MCP server prefers DATABRAIN_SERVICE_TOKEN for org-level operations and can activate per-data-app API tokens during setup.

​
Next Steps

Workflows

Step-by-step guides for common tasks

Client Setup

Detailed configuration per client

Tools Reference

All 36 tools