developer-toolsapi_key

Databox

Connect your data from any tool and track it from any device. Build and share reports, monitor trends, and discover insights.

Verdict

Databox is a business metrics dashboard that aggregates data from multiple sources. This MCP lets your team push custom metrics, create datasets, and manage data sources directly from Switchy conversations. Marketing ops and data analysts get the most value — they can ingest campaign results, sync custom KPIs, or set up new dashboards without leaving the chat. You'll need a Databox API key with write permissions, and you're responsible for matching the schema of any dataset you push to (the MCP won't validate field names or types before sending).

Common use cases

  • Push daily sales metrics from spreadsheets
  • Create custom KPI datasets for executive dashboards
  • Ingest campaign performance after each launch
  • Check ingestion status when data looks stale
  • Delete outdated data sources during cleanup

Integration

Vendor
Databox
Category
developer-tools
Auth
API_KEY
Tools
7
Composio slug
databox

Tools

  • Create Dataset

    Tool to create a new dataset in Databox data source. Use when you need to initialize a dataset with a title, data source ID, and primary keys for unique record identification.

  • Create Data Source

    Tool to create a new data source in Databox. Use when you need to create a logical container for datasets within a Databox account. Requires accountId, title, and timezone parameters.

  • Delete Dataset
    destructive

    Tool to delete a dataset by ID in Databox. Use when you need to permanently remove a dataset. This operation is irreversible.

  • Delete Data Source
    destructive

    Tool to delete a data source by ID in Databox. Use when you need to permanently remove a data source. This operation is irreversible and will delete all associated datasets.

  • Get Dataset Ingestion Status

    Tool to check the status of a specific data ingestion for a dataset. Use when you need to verify whether a data ingestion was successful by providing the dataset ID and ingestion ID returned from the initial POST request.

  • List Accounts

    Tool to retrieve all Databox accounts accessible to the authenticated user. Use to identify account IDs required for subsequent API operations like data source creation.

  • Push Data to Dataset (V1)

    Tool to push data points to a Databox dataset using the v1 API. Use when you need to ingest data records into a specific dataset by providing the dataset ID and an array of records matching the dataset schema.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the MCP integrations panel. 2. Click 'Add Integration' and select Databox from the developer tools category. 3. Open your Databox account, go to Account Settings > API, and generate a new API token with read and write permissions. 4. Paste the token into Switchy's API key field and click 'Connect'. 5. Switchy will verify the token by listing your accessible accounts — if the connection succeeds, you'll see a green checkmark. 6. Open any Space, type '@Databox list my accounts' and send the message to confirm the MCP responds with your account IDs. 7. To push data, you'll need the dataset ID from Databox — create a dataset first if you don't have one, then reference it in your prompts.

What teammates see: by default, memories from Databox are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

List My Accounts

@Databox list all accounts I have access to and show me their IDs and names
Open in a Space →

Create Marketing Dataset

@Databox create a dataset called 'Q1 Campaign Metrics' in data source ID ds_abc123 with primary keys 'campaign_id' and 'date'
Open in a Space →

Push Weekly Sales Data

@Databox push these records to dataset ID dataset_xyz789: [{"date": "2025-01-20", "revenue": 15000, "deals_closed": 8}, {"date": "2025-01-21", "revenue": 12000, "deals_closed": 5}]
Open in a Space →

Check Ingestion Status

@Databox check the ingestion status for dataset ID dataset_xyz789 and ingestion ID ing_456def
Open in a Space →

Clean Up Old Data Source

@Databox delete data source ID ds_old999 and confirm it's been removed from my account
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@databox list all accounts I have access to and show me which data sources exist in my primary account

Output

Found 2 Databox accounts linked to your API key. Your primary account (ID: acc_8x9k2m) 'Acme Analytics' contains 4 active data sources: 'Website Traffic' (last updated 2 hours ago), 'Sales Pipeline' (last updated yesterday), 'Customer Support Metrics' (last updated 6 hours ago), and 'Marketing Campaigns' (last updated 3 days ago). Your secondary account (ID: acc_3j7n1p) 'Client Dashboard' has 1 data source. This example shows typical account structure; your actual configuration will differ.

Notes

This read operation requires only basic API key authentication. Useful for discovery before pushing data or creating new sources. Response time depends on how many accounts and data sources you have configured—larger organizations may see pagination.

Prompt

@databox create a new dataset called 'Q1 Revenue by Region' in my Sales Pipeline data source with primary keys for date and region

Output

Created dataset 'Q1 Revenue by Region' (ID: ds_4k8m2x) in data source 'Sales Pipeline' (ID: src_9n3j7p). Primary keys configured: 'date' and 'region' will ensure each date-region combination updates the same record rather than creating duplicates. Dataset is now ready to receive data via push operations. This example demonstrates typical dataset initialization; actual IDs and confirmation details will vary by your account.

Notes

This write operation permanently modifies your Databox configuration. Choosing correct primary keys is critical—they determine how records update versus append. Once created, you cannot change primary keys without deleting and recreating the dataset, which loses historical data.

Prompt

@databox push this week's signup data to my 'User Growth' dataset and verify the ingestion completed successfully

Output

Pushed 7 records to dataset 'User Growth' (ID: ds_7m2k9x). Ingestion ID: ing_5p8n3j assigned. Checking status... Ingestion completed successfully in 1.2 seconds. All 7 records processed without errors. Data points are now visible in your Databox dashboards. This example illustrates a typical push-and-verify workflow; actual ingestion times and record counts depend on your data volume and API rate limits.

Notes

This combines two operations: pushing data and checking ingestion status. Databox's API is asynchronous—always verify ingestion status for production workflows. Rate limits apply (typically 100 requests/minute). Failed ingestions won't automatically retry; your integration must handle errors and resubmit.

Use-case deep-dives

Weekly exec dashboard refresh

When Databox MCP beats manual CSV uploads for leadership reporting

A 6-person SaaS startup runs weekly board meetings where the CEO needs revenue, churn, and support ticket metrics in one place. The ops lead currently exports CSVs from Stripe, Intercom, and their internal Postgres database, then manually uploads them to Databox every Monday morning. This MCP wins here because it can push data from multiple sources into Databox datasets on a schedule, using the Push Data and Create Dataset tools to automate the entire pipeline. The API key auth means the ops lead sets it up once and the team's AI workspace handles the refresh. If your metrics change more than daily or you need sub-hour latency, this MCP's batch-push model gets clunky—real-time dashboards need webhooks or streaming connectors instead. For weekly or daily cadences under 10 data sources, this is the right call.

Customer success health score tracking

Using Databox MCP to centralize account health metrics

A 12-person B2B customer success team tracks account health across usage logs, support ticket volume, and NPS scores stored in three different tools. The CS ops manager wants a single Databox board showing red/yellow/green health scores per account, updated nightly. This MCP handles it by creating a data source per customer segment, then pushing aggregated health metrics using the Push Data tool with account ID as the primary key. The Get Dataset Ingestion Status tool lets the team verify the nightly job succeeded before the morning standup. The trade-off: if you need to backfill historical data or handle schema changes frequently, the Delete Dataset and Create Dataset tools mean you're rebuilding pipelines manually. For stable schemas and forward-looking metrics, this MCP keeps the CS team's dashboard current without engineering lift.

Agency client reporting automation

When Databox MCP scales multi-client reporting for small agencies

A 4-person marketing agency manages 15 clients, each with their own Google Analytics, Facebook Ads, and email marketing data. The account manager spends 6 hours a month building client reports in Databox by hand. This MCP changes the game by letting the team create one data source per client using the Create Data Source tool, then automate metric pushes from their internal reporting database. The List Accounts tool helps the agency map clients to Databox account IDs, and the 7-tool scope keeps the integration simple enough for a non-technical account manager to maintain. The boundary: if you're managing 50+ clients or need real-time ad spend alerts, the manual data source setup per client becomes a bottleneck. For agencies under 20 clients with weekly or monthly reporting cadences, this MCP turns a half-day task into a 10-minute review.

Frequently asked

What does the Databox MCP let me do in Switchy?

It lets you create data sources and datasets in your Databox account, then push metrics from AI workflows directly into Databox dashboards. You can automate ingestion of custom KPIs, check ingestion status, and manage the lifecycle of datasets—all without leaving Switchy. Think of it as a programmatic bridge between your AI agents and your Databox reporting.

Do I need admin access to connect Databox via API key?

You need a Databox API key with write permissions to create data sources, datasets, and push data. Databox doesn't expose granular scope controls like OAuth apps do—your key either has full access or it doesn't. If you're on a team plan, confirm with your Databox admin that API access is enabled and that you're allowed to generate keys.

Can the Databox MCP pull existing data out of Databox?

No. The seven tools are all write-oriented: create data sources, create datasets, push data points, delete resources, and check ingestion status. If you need to read historical metrics or query existing dashboards, you'll have to use Databox's separate Query API or export CSVs manually. This MCP is for pushing data in, not pulling it out.

Why use this instead of Databox's native integrations?

Databox's native connectors pull from SaaS apps like Google Analytics or Stripe. This MCP is for custom data that lives in your AI workflows—calculated metrics, agent outputs, or anything you're processing in Switchy that doesn't have a pre-built Databox integration. You control the schema and push exactly what you want, when you want.

Who on the team should connect the Databox MCP?

Whoever owns your Databox reporting setup and has API key access. They'll need to know which account ID to target and how your datasets are structured. Once connected in Switchy, any team member with workspace access can trigger the tools—but the person setting it up should understand Databox's data model to avoid creating duplicate sources or malformed datasets.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.