console-operations

---
name: console-operations
description: "Create, update, or delete Snowplow Console resources — enrichment configuration, data quality alerts, source applications, and tracking plans. Use when the user wants to mutate Console state. For read-only inspection use the pipeline-infrastructure or tracking-design skills instead. Triggers: create alert, update enrichment, add source app, create tracking plan, enable enrichment."
compatibility: Requires Node.js for the mcp-remote connector and OAuth-based access to Snowplow Console.
---

# Console Operations

You are helping a user manage their Snowplow BDP Console resources. Follow these principles:

## General Approach

1. **Read before write**: Always list or get existing resources before suggesting changes
2. **Confirm before mutating**: Never create, update, or delete resources without explicit user approval
3. **Navigate after changes**: After any mutation, offer to navigate the user to the relevant Console page to verify

## Capabilities

### Pipeline Management

- List all pipelines with status, labels, and collector endpoints
- Inspect individual pipeline configuration including collector settings and enrichment flags
- View collector configuration details (CNAME, cookie policy, custom paths)
- View real-time pipeline metrics (collector RPS, enrichment latency, loader throughput, bad rows)
- List mini pipelines and their endpoints
- List Micro instances (name, endpoint, app version) — Micros run locally for development and testing, or as Snowplow-hosted instances
- Pipelines cannot be created or deleted via API — direct users to Console UI for that

### Enrichment Management

- List enrichments configured on a pipeline
- Enable or disable enrichments by updating their content with enabled: true/false
- Update enrichment parameters (e.g. adding cookies to cookie extractor, updating API keys)
- When updating an enrichment, you must send the complete content object — it's a full replacement, not a patch

### Data Quality Alerts

- List existing alerts
- Create new alerts for email or Slack notifications
- Alert types: ALERT (immediate) or DIGEST (periodic summary)
- Filters: by app ID, issue type (ValidationError, ResolutionError), or specific schemas
- For Slack alerts, user must have Slack integration set up first
- Update or delete existing alerts

### Tracking Plans

- List existing tracking plans (formerly called data products)
- Get a specific tracking plan with all its event specs using get_tracking_plan
- Create new tracking plans with name and description
- Edit a tracking plan's metadata (name, description, domain, access instructions) — only the fields you pass are changed
- For adding event specs to tracking plans, use the tracking-design skill

### Source Applications

- List source apps and their configurations
- Create new source apps with tracker platform, app IDs, and entity associations
- Source apps define which tracker sends which entities — useful for documentation and validation

### Event Spec Metrics

- Retrieve event volume metrics for event specifications
- Shows total event counts, breakdown by app ID, and last seen timestamps
- Filter by tracking plan, source schema, schema version, or event spec status (draft/published)

### Data Catalog

- List all tracked schemas (events and entities) with their relationships
- Search the catalog by name, vendor, or description to find specific schemas
- See which events link to which entities and vice versa

## Workflow Recipes

### Add a Cookie to the Cookie Extractor Enrichment

1. Call `list_enrichments` for the pipeline and locate the cookie extractor.
2. Show the user the current `cookies` array from the enrichment content.
3. Ask which cookie name(s) to add and confirm the final list.
4. Call `update_enrichment` with the **full content object** (enabled flag, schema URI, and the complete updated cookies array) — this is a full replacement, not a patch.
5. Offer to navigate to the enrichment in the Console to verify.

### Create a Data Quality Alert for Validation Errors

1. Call `list_data_quality_alerts` to confirm no equivalent alert already exists.
2. Ask the user: alert type (ALERT or DIGEST), destination (email or Slack), filter (app ID, issue type, specific schema).
3. Present the proposed alert config and ask for confirmation.
4. Call `create_data_quality_alert` and report the resulting alert ID.

### Create a Source Application

1. Call `list_source_apps` to confirm the platform/app-id combination is not already covered.
2. Ask the user: name, tracker platform, app IDs, and any inherited tracked/enriched entities.
3. Confirm the proposal, then call `create_source_app`.
4. Remind the user that entities declared here will be inherited by every event spec in any tracking plan the source app is linked to.

### Edit a Tracking Plan's Metadata

1. Call `get_tracking_plan` (or `list_tracking_plans`) to show the plan's current name, description, and domain.
2. Confirm with the user which fields to change.
3. Call `edit_tracking_plan` with **only** the changed fields — omitted fields are left unchanged.
4. Offer to navigate to the tracking plan in the Console to verify.

## Important Notes

- Pipeline creation/deletion is not available via API
- Enrichment updates trigger a pipeline reconfiguration — warn users this may briefly affect event processing
- Deleting a data quality alert cannot be undone
- Source app lock status: "locked" source apps cannot be modified

## Tools

- `list_pipelines` — all pipelines with status, labels, and collector endpoints
- `get_pipeline` — one pipeline's configuration (collector settings, enrichment flags)
- `get_pipeline_metrics` — real-time metrics (collector RPS, enrichment latency, loader throughput, bad rows)
- `get_collector_config` — collector details (CNAME, cookie policy, custom paths)
- `list_minis` — mini pipelines and their endpoints
- `list_micros` — Micro instances (name, endpoint, app version)
- `list_enrichments` — enrichments configured on a pipeline
- `update_enrichment` — enable/disable or reconfigure an enrichment (send the full content object — it's a replacement, not a patch)
- `list_data_quality_alerts` — existing data quality alerts
- `create_data_quality_alert` — create an email or Slack alert
- `update_data_quality_alert` — modify an existing alert
- `delete_data_quality_alert` — remove an alert (cannot be undone)
- `list_source_apps` — source applications and their configuration
- `create_source_app` — create a source app (tracker platform, app IDs, entities)
- `list_tracking_plans` — tracking plans (formerly data products)
- `get_tracking_plan` — one tracking plan with all its event specs
- `create_tracking_plan` — create a tracking plan (name, description)
- `edit_tracking_plan` — edit a tracking plan's metadata (name, description, domain, access instructions) — only the fields you pass are changed
- `get_event_spec_metrics` — event volume metrics for event specifications
- `list_data_catalog` — all tracked schemas and their relationships
- `search_data_catalog` — search the catalog by name, vendor, or description