Skip to main content
You’ll need a Databrain account and Node.js 18+ installed. The setup takes about 2 minutes.

​
Prerequisites

  • Node.js 18+ — check with node --version
  • A Databrain account — sign up here if you don’t have one
  • An AI client — Cursor, Claude Desktop, Claude Code, or Windsurf
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 all your Databrain resources.
2

Add to Your AI Client

Add the MCP server configuration to your client. Pick your client below:
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
  "mcpServers": {
    "databrain": {
      "command": "npx",
      "args": ["@databrainhq/mcp-server"],
      "env": {
        "DATABRAIN_SERVICE_TOKEN": "<your-service-token>"
      }
    }
  }
}
For detailed per-client instructions including restart steps and self-hosted configuration, see the Client Setup Guide.
3

Verify the Connection

Open your AI assistant and ask:
“List my Databrain datasources”
If everything is configured correctly, you’ll see your connected datasources listed. This confirms the MCP server is running and your service token is valid.
If you see a MISSING_SERVICE_TOKEN error, double-check that the token is in the env block of your MCP config (not your shell environment) 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 the embed, and generating the frontend code. You approve each step as it goes.Other things to try:
“What was total revenue last month?”
“Brand my embed to match our company colors”
That’s it. The assistant handles the Databrain API so you can focus on building.

​
Next Steps

Workflows

Step-by-step guides for common tasks

Client Setup

Detailed configuration per client

Tools Reference

All 24 available tools