Cube.dev MCP Server for Mastra AIGive Mastra AI instant access to 15 tools to Check Live, Check Ready, Convert Query, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Cube.dev through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Cube.dev MCP Server for Mastra AI is a standout in the Brain Trust category — giving your AI agent 15 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"cubedev": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Cube.dev Agent",
instructions:
"You help users interact with Cube.dev " +
"using 15 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Cube.dev?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Cube.dev MCP Server
Connect your Cube.dev instance to any AI agent to bridge the gap between natural language and your data warehouse. This server allows your agent to interact with Cube's semantic layer, ensuring consistent metrics and high-performance data retrieval.
Mastra's agent abstraction provides a clean separation between LLM logic and Cube.dev tool infrastructure. Connect 15 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Data Querying — Execute complex REST API queries using
load_queryto fetch aggregated data with measures, dimensions, and filters. - SQL Inspection — Use
get_sqlandexecute_cube_sqlto debug or run raw queries against the SQL API for deep data investigation. - Metadata Exploration — Retrieve cube definitions, views, and segments via
get_metato understand your data model without leaving the chat. - Performance Management — Trigger and monitor background pre-aggregation builds with
trigger_pre_aggregation_jobto ensure your dashboards stay fast. - Cloud Management — List deployments and environments if using Cube Cloud to manage your infrastructure context.
The Cube.dev MCP Server exposes 15 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 15 Cube.dev tools available for Mastra AI
When Mastra AI connects to Cube.dev through Vinkius, your AI agent gets direct access to every tool listed below — spanning semantic-layer, data-modeling, sql-api, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Check live on Cube.dev
Check if Cube deployment is live
Check ready on Cube.dev
Check if Cube deployment is ready
Convert query on Cube.dev
Convert a SQL query to a REST API query format
Execute cube sql on Cube.dev
Execute a raw SQL query against the SQL API
Generate meta token on Cube.dev
Requires CUBE_CLOUD_API_KEY. Generate a JWT for the Metadata API
Get entity on Cube.dev
Get detailed metadata for a specific entity
Get meta on Cube.dev
Get metadata for cubes and views
Get pre aggregation job status on Cube.dev
Get status of pre-aggregation jobs
Get sql on Cube.dev
Useful for debugging. Get generated SQL for a Cube query
List data sources on Cube.dev
List configured data sources
List deployments on Cube.dev
Requires CUBE_CLOUD_API_KEY. List all Cube Cloud deployments
List entities on Cube.dev
List all cubes and views
List environments on Cube.dev
Requires CUBE_CLOUD_API_KEY. List environments for a deployment
Load query on Cube.dev
Use this to get aggregated data. Execute a Cube query and return results
Trigger pre aggregation job on Cube.dev
Trigger a pre-aggregation build job
Connect Cube.dev to Mastra AI via MCP
Follow these steps to wire Cube.dev into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Cube.dev MCP Server
Mastra AI provides unique advantages when paired with Cube.dev through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Cube.dev without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Cube.dev tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Cube.dev + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Cube.dev MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Cube.dev, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Cube.dev as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Cube.dev on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Cube.dev tools alongside other MCP servers
Example Prompts for Cube.dev in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Cube.dev immediately.
"Show me the metadata for all available cubes and views."
"Run a query to get the total count of orders grouped by status for the last 30 days."
"Trigger a pre-aggregation build for the 'Sales' cube."
Troubleshooting Cube.dev MCP Server with Mastra AI
Common issues when connecting Cube.dev to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpCube.dev + Mastra AI FAQ
Common questions about integrating Cube.dev MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Gitea
10 toolsManage self-hosted Git via Gitea — list and manage repositories, track issues and pull requests, handle organizations, and audit branches directly from any AI agent.

Helpjuice
12 toolsAutomate knowledge base management via Helpjuice — manage articles, categories, and analytics directly from any AI agent.

Checkly
8 toolsManage application monitoring and E2E testing via Checkly — track API uptime, trigger checks, and monitor performance directly from any AI agent.

TomTom
10 toolsEquip your AI agent with global mapping, routing, and real-time traffic capabilities powered by TomTom.
