@cube-dev/mcp-server

Cube MCP Server

A Model Context Protocol (MCP) server that provides chat functionality with Cube's AI agent for analytics and data exploration.

Features

This MCP server provides:

Tools

• chat: Chat with Cube AI agent for analytics and data exploration (streams real-time responses)

MCP Client Configuration

Cursor or Claude Desktop Configuration

For Cursor and Claude Desktop, add this to your MCP settings:

{
  "mcpServers": {
    "cube-mcp-server": {
      "command": "npx",
      "args": ["@cube-dev/mcp-server"],
      "env": {
        "CUBE_API_KEY": "your_api_key_here",
        "CUBE_TENANT_NAME": "your_tenant_name",
        "CUBE_DEPLOYMENT_ID": "your_deployment_id",
        "CUBE_AGENT_ID": "your_agent_id",
        "USER_ID": "[e-mail]"
      }
    }
  }
}

Obtaining Credentials

• CUBE_API_KEY - Navigate to Admin -> Agent -> Click on Agent -> Enable API Key.
• CUBE_TENANT_NAME - Your tenant name from the URL, e.g. 'acme' in https://acme.cubecloud.dev
• CUBE_DEPLOYMENT_ID - Your deployment ID from Admin -> Settings.
• CUBE_AGENT_ID - Navigate to Admin -> Agent -> Click on Agent to find it.
• USER_ID - A unique identifier for the user (e.g., email address or user ID) used for session generation and personalization.

Cube Chat Examples

Ask questions like "Show me revenue trends" or "What are our top products?" to get real-time analytics responses with data visualizations and SQL queries.

Architecture

Standard MCP server with tools, resources, and stdio transport. Integrates with Cube's streaming chat API using session-based authentication (API key → session → token) and supports user context through external IDs and user attributes. Built with @modelcontextprotocol/sdk.