# Bonnard Cli

> Open-source agentic schema CLI. Optimised for claude code, gemini, codex and co-pilot. Skills included.

- **Type:** MCP server
- **Install:** `agentstack add mcp-bonnard-data-bonnard-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bonnard-data](https://agentstack.voostack.com/s/bonnard-data)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bonnard-data](https://github.com/bonnard-data)
- **Source:** https://github.com/bonnard-data/bonnard-cli
- **Website:** https://www.bonnard.dev

## Install

```sh
agentstack add mcp-bonnard-data-bonnard-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Agent-native analytics. One schema, many surfaces.

  
  
  

  Docs &middot;
  Getting Started &middot;
  Changelog &middot;
  Discord &middot;
  Website

---

BI tools serve one UI. Bonnard serves everything. Agents over MCP, apps over SDK, dashboards in markdown, internal tools via REST. One set of metric definitions, every consumer gets the same governed answer.

  

## Why Bonnard?

Traditional semantic layers were built for dashboards and retrofitted for AI. Agents get different answers than dashboards, metrics drift across tools, and every new surface means another integration. Bonnard was built agent-native from day one. MCP is a core feature, not a plugin. One CLI, one schema, every consumer gets the same governed answer.

## Quick Start

No install required. Run directly with npx:

```bash
npx @bonnard/cli init
```

Or install globally:

```bash
npm install -g @bonnard/cli
```

Then follow the setup flow:

```bash
bon init                      # Scaffold project + agent configs
bon datasource add            # Connect your warehouse
bon validate                  # Check your models locally
bon login                     # Authenticate
bon deploy -m "initial deploy" # Ship it
```

Your semantic layer is now live. Agents, dashboards, and the SDK all query the same governed metrics.

No warehouse yet? Start exploring with a full retail demo dataset:

```bash
bon datasource add --demo
```

Requires Node.js 20+.

## What You Get

- **Agent context out of the box.** `bon init` generates rules and skills for [Claude Code, Cursor, and Codex](https://docs.bonnard.dev/docs/cli) so agents understand your semantic layer from the first prompt.
- **[MCP server](https://docs.bonnard.dev/docs/mcp)** for governed agent queries. Set up with `bon mcp`, test with `bon mcp test`.
- **[Markdown dashboards](https://docs.bonnard.dev/docs/dashboards)** with BigValue, LineChart, BarChart, AreaChart, PieChart, and DataTable components. Preview locally with `bon dashboard dev`, deploy with `bon dashboard deploy`.
- **[JSON and SQL querying](https://docs.bonnard.dev/docs/querying)** from the terminal via `bon query` and `bon schema`, or programmatically via the REST API.
- **Deployment versioning** with change tracking (`bon diff`), annotations (`bon annotate`), and full history (`bon deployments`).
- **CI/CD support.** Run `bon deploy --ci -m "message"` for non-interactive pipelines.

## Supported Data Sources

**Warehouses:** Snowflake (including Snowpark), Google BigQuery, Databricks (SQL warehouses and Unity Catalog), PostgreSQL (including Supabase, Neon, and RDS), Amazon Redshift, DuckDB (including MotherDuck)

**Data tools:** dbt (model and profile import), Dagster, Prefect, Airflow (orchestration), Looker, Cube, Evidence (existing BI layers), SQLMesh, Soda, Great Expectations (data quality)

Bonnard auto-detects your warehouses and data tools. Point it at your project and it discovers schemas, tables, and relationships.

## Ecosystem

- **[@bonnard/sdk](https://www.npmjs.com/package/@bonnard/sdk)**: query the semantic layer from any JavaScript or TypeScript application
- **[@bonnard/react](https://www.npmjs.com/package/@bonnard/react)**: React chart components and a markdown dashboard viewer

## Commands

| Command | Description |
| --- | --- |
| `bon init` | Scaffold a new project with agent configs |
| `bon datasource add` | Connect a data source (or `--demo` for sample data) |
| `bon validate` | Validate YAML syntax locally |
| `bon deploy -m "message"` | Deploy to production |
| `bon pull` | Download deployed models to local project |
| `bon query` | Run queries (JSON or SQL) |
| `bon schema` | Explore deployed measures, dimensions, and views |
| `bon dashboard dev` | Preview a markdown dashboard locally |
| `bon dashboard deploy` | Deploy a dashboard |
| `bon mcp` | MCP server setup instructions |
| `bon keys create` | Create a publishable or secret API key |
| `bon docs` | Browse documentation from the CLI |

See the full [CLI reference](https://docs.bonnard.dev/docs/cli) for all commands and flags.

## Documentation

| Guide | Description |
| --- | --- |
| [Getting Started](https://docs.bonnard.dev/docs/getting-started) | From zero to deployed in minutes |
| [CLI Reference](https://docs.bonnard.dev/docs/cli) | Every command, flag, and option |
| [Modeling Guide](https://docs.bonnard.dev/docs/modeling/cubes) | Cubes, views, metrics, and dimensions |
| [Dashboards](https://docs.bonnard.dev/docs/dashboards) | Markdown dashboards with charts, inputs, and theming |
| [SDK](https://docs.bonnard.dev/docs/sdk) | TypeScript SDK and React components |
| [Querying](https://docs.bonnard.dev/docs/querying) | JSON and SQL query syntax |
| [Changelog](https://docs.bonnard.dev/docs/changelog) | What shipped and when |

## Community

- [Discord](https://discord.com/invite/RQuvjGRz): ask questions, share feedback, connect with the team
- [GitHub Issues](https://github.com/bonnard-data/bonnard-cli/issues): bug reports and feature requests
- [LinkedIn](https://www.linkedin.com/company/bonnarddev/): follow for updates
- [Website](https://www.bonnard.dev): learn more about Bonnard

Contributions are welcome. If you find a bug or have an idea, open an issue or submit a pull request.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bonnard-data](https://github.com/bonnard-data)
- **Source:** [bonnard-data/bonnard-cli](https://github.com/bonnard-data/bonnard-cli)
- **License:** MIT
- **Homepage:** https://www.bonnard.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-bonnard-data-bonnard-cli
- Seller: https://agentstack.voostack.com/s/bonnard-data
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
