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 that can also be used standalone.

Feature	Description	Details
Monitor Creation	Guides AI agents through creating monitors correctly — validates tables, fields, and parameters before generating monitors-as-code YAML.	README
Prevent	Surfaces lineage, alerts, and blast radius before code changes. Generates monitors-as-code and targeted validation queries to prevent data incidents.	README
Generate Validation Notebook	Generates SQL validation notebooks for dbt model changes, with targeted queries comparing baseline and development data.	README
Push Ingestion	Generates warehouse-specific collection scripts for pushing metadata, lineage, and query logs to Monte Carlo.	README

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 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 for detailed setup and usage.

For other coding agents (Cursor, Copilot CLI, OpenCode, Codex), see the plugins page 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 account with Editor role or above

• Monte Carlo MCP server — configure with:

  claude mcp add --transport http monte-carlo-mcp https://integrations.getmontecarlo.com/mcp
  

  Then authenticate: run /mcp in your editor, select monte-carlo-mcp, and complete the OAuth flow.

  See official docs 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 for details.

Installation

npx skills add monte-carlo-data/mc-agent-toolkit --skill prevent

Or copy directly:

cp -r skills/prevent ~/.claude/skills/prevent

See the skills directory for the full list and individual READMEs.

Contributing

See CONTRIBUTING.md for guidelines on adding skills, creating plugins, and submitting pull requests. It also covers plugin architecture and releasing new versions.

License

This project is licensed under the Apache-2.0 license — see LICENSE for details.

Security

See SECURITY.md for reporting vulnerabilities.