# Kyomi

Connect various data sources to visualize, monitor, and analyze complex datasets through interactive dashboards. Automate data monitoring with scheduled reports and alerts that notify you of signific…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add kyomi/kyomi-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list kyomi/kyomi-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get kyomi/kyomi-mcp delete_watch

# Call a tool
npx -y @smithery/cli@latest tool call kyomi/kyomi-mcp delete_watch '{}'
```

## Direct MCP Connection

Endpoint: `https://kyomi-mcp--kyomi.run.tools`

## Tools (27)

- `delete_watch` — Permanently delete a watch. This action cannot be undone. Use update_watch to temporarily disable a watch instead.
- `modify_dashboard` — Update an existing dashboard's title and/or content. You must be the owner to update. Use get_chartml_spec to verify Ch…
- `save_learning` — Save knowledge about how to navigate the data warehouse. NOT for saving analysis results or business insights. IMPORTAN…
- `list_datasources` — List all available datasources in the current workspace. Returns each datasource's slug, name, type, and number of inde…
- `forecast_data` — Run time series forecasting on data from a datasource.
- `browse_resources` — List available Kyomi documentation resources. Returns a catalog of docs:// URIs with titles and descriptions. Use this …
- `get_workspace_info` — Get information about the current workspace including all members and their emails.
- `get_watch_info` — Get detailed information for a specific watch including recent execution history. Use this to view configuration, debug…
- `search_dashboards` — Search for dashboards in the current workspace. Supports sorting by popularity, recency, or creation date. Use this to …
- `render_chart` — Render a ChartML visualization as an interactive chart or PNG image. Accepts a ChartML specification as YAML or JSON st…
- `get_dashboard_info` — Get detailed information about a specific dashboard including full content.
- `update_analytics_site` — Update an analytics site's name, allowed domains, and/or datasource slug. If domains change, the tracking snippet is re…
- `read_resource` — Read a specific Kyomi documentation resource by its docs:// URI. Returns the full markdown content of the document. Use…
- `update_watch` — Update an existing Kyomi Watch. You can change name, prompt, schedule, mode, enabled status, Slack channel, or email al…
- `list_analytics_sites` — List all analytics sites in the current workspace. Returns site details including tracking snippets and linked datasour…
- `create_dashboard` — Create a new dashboard. You MUST search for existing dashboards first using search_dashboards to avoid duplicates. Use …
- `create_watch` — Create a Kyomi Watch - automated data monitoring that runs on a schedule.
- `search_knowledge` — Search the workspace's knowledge base for relevant tables, learnings, and metrics using semantic search. Use this to di…
- `search_watches` — Search for existing watches to avoid duplicates or find watches to modify. Leave the query empty to list all watches. R…
- `get_chartml_spec` — Get ChartML specification documentation for creating visualizations.
- `validate_sql` — Validate SQL query syntax without executing. Returns validation status, error message with line/column if invalid.
- `query_datasource` — Execute a SQL query against any datasource and return results. HARD LIMIT: 20 rows maximum. Use fully qualified table n…
- `get_table_info` — Get detailed information about a table from any datasource. Returns schema, column names, types, descriptions, and meta…
- `trigger_watch` — Manually trigger a watch to run immediately. The watch must be enabled. Use get_watch_info afterwards to see the result…
- `create_analytics_site` — Create an analytics site for tracking website events. Returns a <script> snippet to embed in the site's HTML <head>. Au…
- `delete_analytics_site` — Delete an analytics site and its auto-provisioned datasource. This removes the ClickHouse user, row policy, and all ass…
- `delete_dashboard` — Delete a dashboard. You must be the owner to delete. This action cannot be undone.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get kyomi/kyomi-mcp <tool-name>
```

## Resources

- `ui://kyomi/chart` — Interactive chart visualization powered by ChartML
- `docs://kyomi/analytics` — Set up privacy-focused website analytics with one script tag
- `docs://kyomi/chartml/chart` — ChartML chart component — all visualization types, axes, marks, annotations, line styles, range marks, and dual-axis ch…
- `docs://kyomi/chartml/config` — ChartML config component — scope-level defaults for styles, datasources, and cache settings.
- `docs://kyomi/chartml/grid` — ChartML 12-column grid system — colSpan, multi-chart dashboards, metric card rows, and layout patterns.
- `docs://kyomi/chartml` — Essential reference for creating ChartML visualizations — chart types, syntax, formatting, grid layout, and common patt…
- `docs://kyomi/chartml/params` — ChartML params component — interactive dashboard controls with date, select, multiselect, text, and number inputs.
- `docs://kyomi/chartml/source` — ChartML source component — query, inline data, multi-source charts, cache configuration, and datasource slug usage.
- `docs://kyomi/chartml/style` — ChartML style component — color palettes, themes, number and date formatting, typography, and visual customization.
- `docs://kyomi/chartml/transform` — ChartML transform pipeline — SQL preprocessing, declarative aggregation, time series forecasting, and QuackStats functi…
- `docs://kyomi/connect/configuration` — Configure Kyomi Connect with environment variables, the setup wizard, and health check endpoints.
- `docs://kyomi/connect` — Deploy a lightweight agent inside your network. Database credentials never leave your infrastructure.
- `docs://kyomi/connect/installation` — Install Kyomi Connect using the binary installer, Docker, Docker Compose, Kubernetes Helm, or AWS ECS.
- `docs://kyomi/connect/security` — How Kyomi Connect protects your database credentials with JWT authentication, encrypted transport, and zero credential …
- `docs://kyomi/connect/troubleshooting` — Common Kyomi Connect issues and their solutions: token errors, database connection failures, WebSocket problems, and mo…
- `docs://kyomi/datasources/bigquery`
- `docs://kyomi/datasources/clickhouse`
- `docs://kyomi/datasources/databricks`
- `docs://kyomi/datasources`
- `docs://kyomi/datasources/mysql`
- `docs://kyomi/datasources/postgres`
- `docs://kyomi/datasources/redshift`
- `docs://kyomi/datasources/snowflake`
- `docs://kyomi/datasources/sqlserver`
- `docs://kyomi/datasources/synapse`
- `docs://kyomi/index` — Comprehensive guides for Kyomi — the data intelligence platform. Setup, Connect, ChartML, datasources, and features.
- `docs://kyomi/mcp` — Connect Kyomi to Cursor and Claude Code for AI-powered data analysis in your development environment
- `docs://kyomi/slack` — Query Kyomi by @mentioning in Slack channels, see charts rendered inline
- `docs://kyomi/watches` — Set up AI-powered alerts and scheduled reports that watch your data 24/7
