@bonnard/cli 0.1.4 → 0.1.5

package/dist/bin/bon.mjs

@@ -1979,6 +1979,10 @@ async function deployCommand(options = {}) {
 		console.log(pc.green("Deploy successful!"));
 		console.log(`Deployment ID: ${pc.cyan(response.deployment.id)}`);
 		console.log(`Cube API: ${pc.cyan(`${response.deployment.cubeApiUrl}/cubejs-api/v1`)}`);
+		console.log();
+		console.log(pc.bold("Connect AI agents via MCP:"));
+		console.log(`  MCP URL: ${pc.cyan("https://mcp.bonnard.dev/mcp")}`);
+		console.log(pc.dim(`  Run \`bon mcp\` for setup instructions`));
 	} catch (err) {
 		console.log(pc.red(`Deploy failed: ${err instanceof Error ? err.message : err}`));
 		process.exit(1);
@@ -2091,6 +2095,82 @@ async function testAndSyncDatasources(cwd, options = {}) {
 	return false;
 }
 
+//#endregion
+//#region src/commands/mcp.ts
+const MCP_URL = "https://mcp.bonnard.dev/mcp";
+function mcpCommand() {
+	console.log(pc.bold("MCP Connection Info"));
+	console.log();
+	console.log(`MCP URL: ${pc.cyan(MCP_URL)}`);
+	console.log();
+	console.log(pc.bold("Setup Instructions"));
+	console.log();
+	console.log(pc.underline("Claude Desktop"));
+	console.log(`Add to ${pc.dim("~/Library/Application Support/Claude/claude_desktop_config.json")}:`);
+	console.log();
+	console.log(pc.dim(`  {`));
+	console.log(pc.dim(`    "mcpServers": {`));
+	console.log(pc.dim(`      "bonnard": {`));
+	console.log(pc.dim(`        "url": "${MCP_URL}"`));
+	console.log(pc.dim(`      }`));
+	console.log(pc.dim(`    }`));
+	console.log(pc.dim(`  }`));
+	console.log();
+	console.log(pc.underline("Cursor"));
+	console.log(`Add to ${pc.dim(".cursor/mcp.json")} in your project:`);
+	console.log();
+	console.log(pc.dim(`  {`));
+	console.log(pc.dim(`    "mcpServers": {`));
+	console.log(pc.dim(`      "bonnard": {`));
+	console.log(pc.dim(`        "url": "${MCP_URL}"`));
+	console.log(pc.dim(`      }`));
+	console.log(pc.dim(`    }`));
+	console.log(pc.dim(`  }`));
+	console.log();
+	console.log(pc.underline("Claude Code"));
+	console.log(`Add to ${pc.dim(".mcp.json")} in your project:`);
+	console.log();
+	console.log(pc.dim(`  {`));
+	console.log(pc.dim(`    "mcpServers": {`));
+	console.log(pc.dim(`      "bonnard": {`));
+	console.log(pc.dim(`        "type": "url",`));
+	console.log(pc.dim(`        "url": "${MCP_URL}"`));
+	console.log(pc.dim(`      }`));
+	console.log(pc.dim(`    }`));
+	console.log(pc.dim(`  }`));
+	console.log();
+	console.log(pc.dim("OAuth authentication happens automatically when you first connect."));
+	console.log(pc.dim("Run `bon mcp test` to verify the MCP server is reachable."));
+}
+
+//#endregion
+//#region src/commands/mcp-test.ts
+const MCP_SERVER_BASE = "https://mcp.bonnard.dev";
+async function mcpTestCommand() {
+	console.log(pc.dim("Testing MCP server connection..."));
+	console.log();
+	const url = `${MCP_SERVER_BASE}/.well-known/oauth-authorization-server`;
+	try {
+		const res = await fetch(url);
+		if (!res.ok) {
+			console.log(pc.red(`✗ MCP server returned ${res.status}`));
+			process.exit(1);
+		}
+		const metadata = await res.json();
+		console.log(pc.green("✓ MCP server is reachable"));
+		console.log();
+		console.log(`  Issuer: ${pc.dim(metadata.issuer || "unknown")}`);
+		console.log(`  Authorization: ${pc.dim(metadata.authorization_endpoint || "unknown")}`);
+		console.log(`  Token: ${pc.dim(metadata.token_endpoint || "unknown")}`);
+		console.log(`  Registration: ${pc.dim(metadata.registration_endpoint || "unknown")}`);
+		console.log();
+		console.log(pc.dim("OAuth endpoints are healthy. Agents can connect."));
+	} catch (err) {
+		console.log(pc.red(`✗ Failed to reach MCP server: ${err instanceof Error ? err.message : err}`));
+		process.exit(1);
+	}
+}
+
 //#endregion
 //#region src/commands/docs.ts
 const __filename = fileURLToPath(import.meta.url);
@@ -2332,6 +2412,7 @@ datasource.command("push").description("Push a local data source to Bonnard serv
 program.command("preview").description("Preview data from a local warehouse using raw SQL (for development/exploration)").argument("<datasource>", "Data source name from .bon/datasources.yaml").argument("<sql>", "SQL query to execute").option("--schema <schema>", "Override schema").option("--database <database>", "Override database").option("--limit <limit>", "Max rows to return", "1000").option("--format <format>", "Output format: toon or json", "toon").action(previewCommand);
 program.command("validate").description("Validate YAML syntax in models/ and views/").option("--test-connection", "Also test datasource connections (warns on failure, doesn't block)").action(validateCommand);
 program.command("deploy").description("Deploy models to Bonnard. Requires login, validates models, tests connections (fails on error)").option("--ci", "Non-interactive mode (fail if missing datasources)").option("--push-datasources", "Auto-push missing datasources without prompting").action(deployCommand);
+program.command("mcp").description("MCP connection info and setup instructions").action(mcpCommand).command("test").description("Test MCP server connectivity").action(mcpTestCommand);
 program.command("cube").description("Query the deployed Cube semantic layer").command("query").description("Execute a query against the deployed semantic layer").argument("<query>", "JSON query or SQL (with --sql flag)").option("--sql", "Use Cube SQL API instead of JSON format").option("--limit <limit>", "Max rows to return").option("--format <format>", "Output format: toon or json", "toon").action(cubeQueryCommand);
 program.command("docs").description("Browse Cube documentation for building models and views").argument("[topic]", "Topic to display (e.g., cubes, cubes.measures)").option("-r, --recursive", "Show topic and all child topics").option("-s, --search <query>", "Search topics for a keyword").option("-f, --format <format>", "Output format: markdown or json", "markdown").action(docsCommand).command("schema").description("Show JSON schema for a type (cube, view, measure, etc.)").argument("<type>", "Schema type to display").action(docsSchemaCommand);
 program.parse();

package/dist/docs/README.md

@@ -58,9 +58,6 @@ Short explanation (2-3 sentences).
 - related.topic
 - another.topic
 
-## More Information
-
-https://cube.dev/docs/...
 ```
 
 ## Guidelines
@@ -68,7 +65,6 @@ https://cube.dev/docs/...
 - Keep topics concise (~20-40 lines)
 - Lead with examples, not theory
 - Use tables for property references
-- Link to cube.dev for exhaustive details
 - Include "See Also" for discoverability
 
 ## Commands

package/dist/docs/_index.md

@@ -58,6 +58,7 @@
 - [workflow.validate](workflow.validate) - Validate models locally
 - [workflow.deploy](workflow.deploy) - Deploy to Bonnard
 - [workflow.query](workflow.query) - Query the deployed semantic layer
+- [workflow.mcp](workflow.mcp) - Connect AI agents via MCP
 
 ## Quick Reference
 

package/dist/docs/topics/cubes.data-source.md

@@ -90,7 +90,3 @@ Cubes from different data sources cannot be directly joined. Use views or pre-ag
 - cubes
 - cubes.sql
 - workflow.deploy
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/cube#data-source

package/dist/docs/topics/cubes.dimensions.format.md

@@ -193,7 +193,3 @@ Format support varies by visualization tool. Most tools recognize common formats
 - cubes.dimensions
 - cubes.dimensions.types
 - cubes.measures.format
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/types-and-formats#format

package/dist/docs/topics/cubes.dimensions.md

@@ -182,7 +182,3 @@ Create derived attributes:
 - cubes.dimensions.primary-key
 - cubes.dimensions.time
 - cubes.joins
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/dimensions

package/dist/docs/topics/cubes.dimensions.primary-key.md

@@ -104,7 +104,3 @@ Primary keys determine how pre-aggregations handle duplicates.
 - cubes.dimensions
 - cubes.dimensions.types
 - cubes.joins
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/dimensions#primary-key

package/dist/docs/topics/cubes.dimensions.sub-query.md

@@ -172,7 +172,3 @@ dimensions:
 - cubes.dimensions
 - cubes.joins
 - cubes.measures
-
-## More Information
-
-https://cube.dev/docs/product/data-modeling/concepts/calculated-members#subquery-dimensions

package/dist/docs/topics/cubes.dimensions.time.md

@@ -109,7 +109,3 @@ For consistent timezone handling, convert in SQL:
 - cubes.dimensions
 - cubes.dimensions.types
 - cubes.measures.rolling
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/dimensions#time-dimensions

package/dist/docs/topics/cubes.dimensions.types.md

@@ -105,7 +105,3 @@ Dimension with predefined set of values.
 - cubes.dimensions
 - cubes.dimensions.primary-key
 - cubes.dimensions.time
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/types-and-formats#dimension-types

package/dist/docs/topics/cubes.extends.md

@@ -147,7 +147,3 @@ cubes:
 - cubes
 - syntax.references
 - syntax.context-variables
-
-## More Information
-
-https://cube.dev/docs/product/data-modeling/concepts/code-reusability-extending-cubes

package/dist/docs/topics/cubes.hierarchies.md

@@ -172,7 +172,3 @@ Hierarchy support varies by visualization tool. Check your specific tool's docum
 - cubes.dimensions
 - cubes.joins
 - views.folders
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/hierarchies

package/dist/docs/topics/cubes.joins.md

@@ -113,7 +113,3 @@ cubes:
 - cubes
 - cubes.dimensions.primary-key
 - views
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/joins

package/dist/docs/topics/cubes.md

@@ -115,7 +115,3 @@ models/
 - cubes.dimensions
 - cubes.joins
 - cubes.segments
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/cube

package/dist/docs/topics/cubes.measures.calculated.md

@@ -97,7 +97,3 @@ Always use `NULLIF` to prevent division by zero:
 - cubes.measures
 - cubes.measures.types
 - cubes.measures.rolling
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/measures#calculated-measures

package/dist/docs/topics/cubes.measures.drill-members.md

@@ -156,7 +156,3 @@ Drill-down support varies by visualization tool. Check your specific tool's docu
 - cubes.measures
 - cubes.dimensions
 - cubes.joins
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/measures#drill-members

package/dist/docs/topics/cubes.measures.filters.md

@@ -84,7 +84,3 @@ measures:
 - cubes.measures
 - cubes.measures.calculated
 - cubes.segments
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/measures#filters

package/dist/docs/topics/cubes.measures.format.md

@@ -151,7 +151,3 @@ Format support varies by visualization tool. Most tools recognize `percent` and
 - cubes.measures
 - cubes.measures.types
 - cubes.dimensions.format
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/types-and-formats#format

package/dist/docs/topics/cubes.measures.md

@@ -160,7 +160,3 @@ Calculate metrics over time windows:
 - cubes.measures.filters
 - cubes.measures.calculated
 - cubes.measures.rolling
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/measures

package/dist/docs/topics/cubes.measures.rolling.md

@@ -117,7 +117,3 @@ rolling_window:
 - cubes.measures.calculated
 - cubes.dimensions.time
 - pre-aggregations
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/measures#rolling-window

package/dist/docs/topics/cubes.measures.types.md

@@ -120,7 +120,3 @@ Custom aggregate function (advanced).
 - cubes.measures
 - cubes.measures.calculated
 - cubes.measures.filters
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/types-and-formats#measure-types

package/dist/docs/topics/cubes.public.md

@@ -170,7 +170,3 @@ cubes:
 - cubes.measures
 - cubes.dimensions
 - views
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/cube#public

package/dist/docs/topics/cubes.refresh-key.md

@@ -151,7 +151,3 @@ pre_aggregations:
 - cubes
 - pre-aggregations
 - pre-aggregations.rollup
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/cube#refresh-key

package/dist/docs/topics/cubes.segments.md

@@ -119,7 +119,3 @@ segments:
 - cubes
 - cubes.measures.filters
 - views
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/segments

package/dist/docs/topics/cubes.sql.md

@@ -59,7 +59,3 @@ cubes:
 - cubes
 - cubes.data-source
 - syntax.references
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/cube#sql

package/dist/docs/topics/pre-aggregations.md

@@ -124,7 +124,3 @@ measures:
 - pre-aggregations.rollup
 - cubes.measures
 - cubes.dimensions.time
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/pre-aggregations

package/dist/docs/topics/pre-aggregations.rollup.md

@@ -160,7 +160,3 @@ A query uses a rollup if:
 - pre-aggregations
 - cubes.dimensions.time
 - cubes.measures
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/pre-aggregations#rollup

package/dist/docs/topics/syntax.context-variables.md

@@ -151,7 +151,3 @@ dimensions:
 - syntax
 - syntax.references
 - cubes.extends
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/context-variables

package/dist/docs/topics/syntax.md

@@ -131,7 +131,3 @@ public: false
 - syntax.references
 - cubes
 - views
-
-## More Information
-
-https://cube.dev/docs/product/data-modeling/syntax

package/dist/docs/topics/syntax.references.md

@@ -172,7 +172,3 @@ sql: "metadata->>'\{key\}'"
 - syntax
 - cubes.measures.calculated
 - cubes.joins
-
-## More Information
-
-https://cube.dev/docs/product/data-modeling/syntax#references

package/dist/docs/topics/views.cubes.md

@@ -160,7 +160,3 @@ views:
 - views
 - views.includes
 - cubes.joins
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/view#cubes

package/dist/docs/topics/views.folders.md

@@ -152,7 +152,3 @@ folders:
 - views
 - views.cubes
 - views.includes
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/view#folders

package/dist/docs/topics/views.includes.md

@@ -137,7 +137,3 @@ Use `"*"` to include all, then exclude what you don't need:
 - views
 - views.cubes
 - views.folders
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/view#includes

package/dist/docs/topics/views.md

@@ -136,7 +136,3 @@ views/
 - views.includes
 - views.folders
 - cubes.joins
-
-## More Information
-
-https://cube.dev/docs/reference/data-model/view

package/dist/docs/topics/workflow.deploy.md

@@ -126,7 +126,3 @@ Run: bon login
 - workflow.validate
 - cubes
 - views
-
-## More Information
-
-https://docs.bonnard.dev/cli/deploy

package/dist/docs/topics/workflow.mcp.md

@@ -0,0 +1,100 @@
+# workflow.mcp
+
+> Connect AI agents to your semantic layer via MCP.
+
+## Overview
+
+After deploying models with `bon deploy`, AI agents (Claude, Cursor, etc.) can query your semantic layer through the Model Context Protocol (MCP). Bonnard's MCP server provides tools for querying cubes and views using natural language.
+
+## MCP URL
+
+```
+https://mcp.bonnard.dev/mcp
+```
+
+## Setup
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "bonnard": {
+      "url": "https://mcp.bonnard.dev/mcp"
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "bonnard": {
+      "url": "https://mcp.bonnard.dev/mcp"
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to `.mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "bonnard": {
+      "type": "url",
+      "url": "https://mcp.bonnard.dev/mcp"
+    }
+  }
+}
+```
+
+## Authentication
+
+MCP uses OAuth 2.0 with PKCE. When an agent first connects:
+
+1. Agent discovers OAuth endpoints via `/.well-known/oauth-authorization-server`
+2. Agent registers as an OAuth client
+3. User is redirected to Bonnard to sign in and authorize
+4. Agent receives an access token (valid for 7 days)
+5. Token persists across server restarts
+
+No API keys or manual token management needed.
+
+## Testing
+
+```bash
+# Verify the MCP server is reachable
+bon mcp test
+
+# View connection info and config snippets
+bon mcp
+```
+
+## Available Tools
+
+Once connected, AI agents can use these MCP tools:
+
+| Tool | Description |
+|------|-------------|
+| `query` | Execute a Cube query (measures, dimensions, filters) |
+| `sql_query` | Execute a SQL query via Cube SQL API |
+| `list_cubes` | List available cubes and their members |
+| `list_views` | List available views and their members |
+
+## Managing Connections
+
+Active MCP connections can be viewed and revoked in the Bonnard dashboard at **Settings > Connections**.
+
+## See Also
+
+- workflow.deploy
+- workflow.query

package/dist/docs/topics/workflow.md

@@ -145,7 +145,3 @@ models/
 - workflow.deploy
 - cubes
 - views
-
-## More Information
-
-https://docs.bonnard.dev/workflow

package/dist/docs/topics/workflow.query.md

@@ -196,8 +196,3 @@ bon cube query '{
 - [cubes.measures](cubes.measures) - Define measures
 - [cubes.dimensions](cubes.dimensions) - Define dimensions
 - [views](views) - Create focused query interfaces
-
-## More Information
-
-- [Cube REST API Query Format](https://cube.dev/docs/product/apis-integrations/rest-api/query-format)
-- [Cube SQL API Query Format](https://cube.dev/docs/product/apis-integrations/sql-api/query-format)

package/dist/docs/topics/workflow.validate.md

@@ -150,7 +150,3 @@ measures:
 - workflow
 - workflow.deploy
 - syntax
-
-## More Information
-
-https://docs.bonnard.dev/cli/validate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonnard/cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "bin": {
     "bon": "./dist/bin/bon.mjs"