https://github.com/monte-carlo-data/mc-agent-toolkit
Official Monte Carlo toolkit for AI coding agents. Skills and plugins that bring data and agent observability — monitoring, triaging, troubleshooting, health checks — into Claude Code, Cursor, and more.
https://github.com/monte-carlo-data/mc-agent-toolkit
agent-observability agent-skills ai-agents claude-code codex-skills cursor data-observability data-quality mcp monte-carlo opencode skill-md skillsmp vscode
Last synced: about 2 months ago
JSON representation
Official Monte Carlo toolkit for AI coding agents. Skills and plugins that bring data and agent observability — monitoring, triaging, troubleshooting, health checks — into Claude Code, Cursor, and more.
- Host: GitHub
- URL: https://github.com/monte-carlo-data/mc-agent-toolkit
- Owner: monte-carlo-data
- License: apache-2.0
- Created: 2026-02-25T18:28:07.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-13T21:49:56.000Z (2 months ago)
- Last Synced: 2026-04-13T23:02:51.465Z (2 months ago)
- Topics: agent-observability, agent-skills, ai-agents, claude-code, codex-skills, cursor, data-observability, data-quality, mcp, monte-carlo, opencode, skill-md, skillsmp, vscode
- Language: Python
- Homepage: https://docs.getmontecarlo.com/docs/agent-toolkit
- Size: 722 KB
- Stars: 75
- Watchers: 1
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# MC Agent Toolkit
Monte Carlo's official toolkit for AI coding agents. Brings data observability — lineage, monitoring, validation, alerting, and metadata ingestion — directly into your development workflow. The toolkit bundles multiple skills into a single plugin that works across supported editors.
## Features
The toolkit bundles the following capabilities as a single **mc-agent-toolkit** plugin. Each feature is a [skill](skills/) that can also be used standalone.
| Feature | Description | Details |
|---|---|---|
| **Incident Response** | Orchestrates incident response — triage alerts, investigate root causes, remediate issues, and add monitoring to prevent recurrence. | [SKILL](skills/incident-response/SKILL.md) |
| **Asset Health** | Checks the health of a data table — surfaces last activity, alerts, monitoring coverage, importance, and upstream dependency health. | [README](skills/asset-health/README.md) |
| **Monitoring Advisor** | Analyzes data coverage, creates monitors for warehouse tables and AI agents — covers coverage gaps, use-case analysis, data monitor creation, and agent observability. | [README](skills/monitoring-advisor/README.md) |
| **Proactive Monitoring** | Guides users from coverage analysis to monitor creation. Sequences asset-health assessment, gap identification via monitoring-advisor, and monitor creation into a guided workflow. | [SKILL](skills/proactive-monitoring/SKILL.md) |
| **Prevent** | Surfaces lineage, alerts, and blast radius before code changes. Generates monitors-as-code and targeted validation queries to prevent data incidents. | [README](skills/prevent/README.md) |
| **Generate Validation Notebook** | Generates SQL validation notebooks for dbt model changes, with targeted queries comparing baseline and development data. | [README](skills/generate-validation-notebook/README.md) |
| **Push Ingestion** | Generates warehouse-specific collection scripts for pushing metadata, lineage, and query logs to Monte Carlo. | [README](skills/push-ingestion/README.md) |
| **Automated Triage** | Guides AI agents through automated alert triage — scoring alerts, running deep troubleshooting on high-signal ones, classifying, and taking actions. | [SKILL](skills/automated-triage/SKILL.md) |
| **Analyze Root Cause** | Investigates data incidents — freshness, volume, schema, ETL, query changes — with systematic root cause analysis using lineage and observability data. | [README](skills/analyze-root-cause/README.md) |
| **Storage Cost Analysis** | Identifies storage waste patterns (unread, zombie, dead-end tables) and recommends safe cleanup with cost estimates. | [README](skills/storage-cost-analysis/README.md) |
| **Performance Diagnosis** | Diagnoses slow pipelines and expensive queries across Airflow, dbt, and Databricks with tiered investigation. | [README](skills/performance-diagnosis/README.md) |
| **Remediation** | Investigates and remediates data quality alerts — runs TSA root cause analysis, discovers available tools, executes fixes (or escalates), and documents the resolution. | [README](skills/remediation/README.md) |
| **Tune Monitor** | Analyzes a Monte Carlo metric monitor's alert history and recommends configuration changes to reduce noise — sensitivity, WHERE conditions, segment exclusions, schedule, and aggregation. | [SKILL](skills/tune-monitor/SKILL.md) |
| **Connection Auth Rules** | Build a Connection Auth Rules configuration for a Monte Carlo connection type. Fetches live connector schemas and transform steps from the apollo-agent repo. | [SKILL](skills/connection-auth-rules/SKILL.md) |
## Installing the plugin (recommended)
**Monte Carlo recommends installing the mc-agent-toolkit plugin.** The plugin bundles all skills together with hooks, the Monte Carlo MCP server, and agent-specific capabilities — no separate MCP configuration or authentication setup needed. See the [plugins page](plugins/) for the full list of supported coding agents.
### Claude Code
1. Add the marketplace:
```
/plugin marketplace add monte-carlo-data/mc-agent-toolkit
```
2. Install the plugin:
```
/plugin install mc-agent-toolkit@mc-marketplace
```
3. Updates — `claude plugin update` pulls in the latest skill and hook changes.
See the [Claude Code plugin README](plugins/claude-code/README.md) for detailed setup and usage.
For other coding agents (Cursor, Copilot CLI, OpenCode, Codex), see the [plugins page](plugins/) for installation guides.
## Using skills directly (advanced)
Skills can also be used standalone without the plugin. This is for users who want to install individual skills via registries or use them with agents not listed above.
### Prerequisites
- A [Monte Carlo](https://www.montecarlodata.com) account with Editor role or above
- Monte Carlo MCP server — configure with:
```
claude mcp add --transport http monte-carlo-mcp https://mcp.getmontecarlo.com/mcp
```
Then authenticate: run `/mcp` in your editor, select `monte-carlo-mcp`, and complete the OAuth flow.
See [official docs](https://docs.getmontecarlo.com/docs/mcp-server#option-1-oauth-21-recommended-for-mcp-clients-that-support-http-transport) for other MCP clients and advanced options.
Legacy: header-based auth (for MCP clients without HTTP transport)
If your MCP client doesn't support HTTP transport, use `.mcp.json.example` with `npx mcp-remote` and header-based authentication. See the [MCP server docs](https://docs.getmontecarlo.com/docs/mcp-server) for details.
### Installation
```bash
npx skills add monte-carlo-data/mc-agent-toolkit --skill prevent
```
Or copy directly:
```bash
cp -r skills/prevent ~/.claude/skills/prevent
```
See the [skills directory](skills/) for the full list and individual READMEs.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding skills, creating plugins, and submitting pull requests. It also covers [plugin architecture](docs/plugin-architecture-guide.md) and [releasing new versions](CONTRIBUTING.md#releasing).
## License
This project is licensed under the Apache-2.0 license — see [LICENSE](LICENSE) for details.
## Security
See [SECURITY.md](SECURITY.md) for reporting vulnerabilities.