Query and analyze your data using AI tools and Databox MCP

Availability

Admins

All accounts

The Databox Model Context Protocol (MCP) server lets you connect AI assistants like Claude, ChatGPT, and Gemini directly to your Databox account, so you can interact with your business data using natural language without leaving your AI chat interface. MCP standardizes how AI systems discover available tools, understand their capabilities, and execute actions on your behalf, making it possible to ask questions, fetch data, and trigger workflows in Databox while keeping access controlled and auditable.

MCP overview

Model Context Protocol (MCP) is an open standard that allows AI assistants to securely connect to external data sources and tools. Think of it as a bridge that lets your AI assistant access and interact with your Databox account while you chat.

With Databox MCP, you can:

Query your data using natural language instead of building metrics manually
Get instant insights by asking questions like "What were our top traffic sources last month?"
Automate data tasks such as creating data sources, ingesting data, or other supported actions
Contextualize Databox data using other tools connected to your AI assistant

MCP tools overview

MCP tools are the individual actions exposed by an MCP server. Each tool has a clear name, description, and input schema so an AI model knows when and how to use it.

In Databox MCP, tools are used when a request requires live data or an action that cannot be answered from the model’s existing context. For example:

Retrieving metric values or dataset rows
Listing available metrics or datasets
Validating inputs before running an operation

You can view the complete and up-to-date list of available Databox MCP tools in the official developer documentation.

Note: MCP tools do not give models unrestricted access. Each tool enforces Databox permissions and only exposes what the authenticated user is allowed to see or do.

The model decides when to call a tool based on the user's request. If the request can be answered without Databox data, no tool is used. If Databox data is required, the model selects the appropriate MCP tool and sends a structured request. For example:

When you ask "What columns are in my sales dataset?" → The assistant uses the ask_genie tool
When you request "Show me Google Analytics sessions for January" → The assistant uses list_metrics and load_metric_data tools
When you say "Create a new data source for marketing data" → The assistant uses the create_data_source tool

Connect an AI or automation tool to Databox MCP

You can connect multiple AI models and automation platforms to the Databox MCP server. The setup flow is similar across clients and is based on secure authentication and MCP configuration.

Note: Some AI and automation tools restrict MCP connector access to specific plans, user roles, or workspace settings. In some cases, a workspace administrator must enable required features before other users can connect Databox MCP. For details on tool-specific requirements, refer to the Databox developer documentation.

ChatGPT Open Settings in ChatGPT by clicking your profile menu and selecting Settings. Go to Apps to manage integrations. Open Advanced settings to view additional configuration options. Enable Developer Mode (Beta) to allow custom MCP connectors and tools. Click Create app to add a new connector for Databox MCP. Enter the app details in the New App setup screen: Name: Databox MCP server URL: `https://mcp.databox.com/mcp` Authorization: OAuth 2.0 Authenticate with Databox when prompted to allow ChatGPT to securely call the Databox MCP on your behalf.
Claude Open Settings in Claude by clicking your profile menu and selecting Settings. Go to Connectors to manage integrations. Click Add custom connector to create a new connector for Databox MCP. Enter the connector details in the Add custom connector window: Name: Databox Remote MCP server URL: `https://mcp.databox.com/mcp` Authenticate with Databox when prompted to allow Claude to securely call the Databox MCP on your behalf.
Gemini Gemini does not currently support MCP directly. To use Gemini models with Databox MCP, you need to run Goose locally as an MCP client. Create a Gemini API key by clicking Create API key in the Gemini console. Name the API key by entering a descriptive name in the text field. Create a new project for the API key by clicking Create project. Enter a project name and click Create project to finalize it. Copy the API key by clicking the copy icon. Open the Goose app and paste your Gemini API key, then confirm. Select a Gemini model and click Select model to continue. Open Extensions in Goose and click Add custom extension. Enter the extension details: Extension name: Databox Type: HTTP Endpoint: `https://mcp.databox.com/mcp` Click Add Extension to register Databox MCP with Goose and Gemini. Start a new chat and click the dumbbell icon. Enable Databox, which opens a browser window for authentication. Log in to Databox to authorize the connection.
n8n Create a new workflow and click the plus icon to add the first step. Search for AI agent and select AI Agent to add it to the workflow. Return to the canvas to open the workflow editor. Click the plus icon on the AI Agent node to add a tool. Select MCP Client Tool to connect the AI agent to Databox MCP. Enter the Databox MCP server URL in the Endpoint field: `https://mcp.databox.com/mcp`. Open the Authentication dropdown and select MCP OAuth2. Select a credential for MCP OAuth2 API, or click Create new credential to add one. Paste the Databox MCP server URL again in the Server URL field. Click Connect my account to start the OAuth sign-in flow. Sign in to Databox and authorize the connection in the pop-up window, then close it. Click Execute step to establish the connection. Open the Tool name dropdown and select an MCP tool operation. Select `list_accounts` and execute the step to verify the connection. Return to the canvas to continue building your workflow.

Frequently Asked Questions

Can the AI assistant modify or delete my Databox data?

Yes. The MCP server includes tools for creating, updating, and deleting data sources and datasets. Destructive actions are only performed when you explicitly request them, such as “delete this dataset.” Always review and confirm AI-suggested actions before proceeding.

Do I need coding knowledge to use the Databox MCP server?

No. Once the connection is set up, you can interact with Databox using natural language through your AI assistant. Coding is not required for basic usage.

Do MCP tools replace the Databox API?

No. MCP tools are built on top of the Databox APIs. They provide a standardized way for AI systems to use Databox without requiring custom integrations.

Is my data secure when using Databox MCP with AI tools like Claude or ChatGPT?

Claude (Anthropic) and ChatGPT (OpenAI) are SOC 2 certified, meaning they meet established standards for data security, availability, and confidentiality.

When using Databox MCP, these AI tools do not store your Databox data. They retrieve data on demand through secure, authenticated requests. All access is governed by Databox’s existing permission model, so the AI can only access data that the authenticated user is already authorized to view.

For more details on privacy and security considerations, refer to the Databox MCP Security documentation.

Is there a cost to use the Databox MCP server?

There is no additional usage cost on the Databox side for using the MCP server beyond your existing Databox subscription. However, your AI tool or automation platform may have its own subscription fees, usage limits, or API costs that apply when making MCP requests.

What is the difference between Databox MCP and Databox native integrations?

Databox native integrations automatically pull data from platforms like Google Analytics or Salesforce into Databox. The Databox MCP server lets AI assistants interact with your Databox account by querying data, creating resources, and analyzing metrics using natural language, acting as a conversational interface to your Databox data.

Still need help?

Visit our community, send us an email, or start a chat in Databox.