# googlecloudplatform/data-agent-kit-plugin architecture

> Architecture diagram of the GitHub repository googlecloudplatform/data-agent-kit-plugin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/data-agent-kit-plugin
- Repository: https://github.com/googlecloudplatform/data-agent-kit-plugin

## Overview

Data Agent Kit is a coding-agent plugin whose main workflow is to take a plain-language data task and guide the agent through domain-specific skills; its notebook MCP server provides direct notebook operations. The README documents broader capabilities for data engineering, science, analysis, and troubleshooting, represented below as skill subsystems rather than inferred internal call chains. Source excerpts show the MCP server dispatching notebook operations and those tools reading or writing notebook files; most skill internals were not sampled, so their internal relationships are omitted.

Main entry points: [`skills`](https://github.com/googlecloudplatform/data-agent-kit-plugin/tree/main/skills) (Data Agent Kit skills), [`mcp/server.ts`](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/server.ts) (Notebook MCP server), [`mcp/tools/create_notebook.ts`](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/create_notebook.ts) (Create notebook), [`mcp/tools/insert_cell.ts`](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/insert_cell.ts) (Cell editing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Agent integration"]
  node_dak_skills["Data Agent Kit skills"]
  node_setup["Kit setup<br/>[SKILL.md]"]
end

subgraph group_notebook["Notebook tools"]
  node_mcp_server["Notebook MCP server<br/>[server.ts]"]
  node_notebook_proxy["Notebook and visualization proxy"]
  node_create_nb["Create notebook<br/>[create_notebook.ts]"]
  node_cell_ops["Cell editing<br/>[insert_cell.ts]"]
  node_read_ops["Cell reading<br/>[read_cell.ts]"]
  node_list_ops["List cells<br/>[list_cells.ts]"]
  node_search_ops["Search cells<br/>[search_cells.ts]"]
  node_output_ops["Cell outputs"]
  node_notebook_files["Jupyter notebook files"]
end

subgraph group_data["Data workflows"]
  node_engineering["Data engineering<br/>[SKILL.md]"]
  node_analysis["Data analysis<br/>[SKILL.md]"]
  node_bigquery_ml["BigQuery AI and ML<br/>[SKILL.md]"]
  node_notebook_guidance["Notebook guidance<br/>[SKILL.md]"]
  node_bigframes["BigQuery BigFrames<br/>[SKILL.md]"]
end

subgraph group_cloud["Cloud operations"]
  node_airflow["Airflow recommendations<br/>[SKILL.md]"]
  node_spark_troubleshoot["Spark troubleshooting<br/>[SKILL.md]"]
  node_security_assessment["Storage security assessment<br/>[SKILL.md]"]
  node_catalog["Data asset discovery<br/>[SKILL.md]"]
end

node_user(("Data practitioner"))
node_coding_agent(("Coding agent"))
node_external_cloud{{"Google Cloud services"}}

node_user -->|"prompts"| node_coding_agent
node_coding_agent -->|"uses plugin"| node_dak_skills
node_coding_agent -->|"invokes setup"| node_setup
node_dak_skills -->|"supports pipelines"| node_engineering
node_dak_skills -->|"supports analysis"| node_analysis
node_dak_skills -->|"supports ML"| node_bigquery_ml
node_dak_skills -->|"guides notebooks"| node_notebook_guidance
node_dak_skills -.->|"supports data science"| node_bigframes
node_dak_skills -->|"supports orchestration"| node_airflow
node_dak_skills -->|"troubleshoots jobs"| node_spark_troubleshoot
node_dak_skills -.->|"assesses storage"| node_security_assessment
node_dak_skills -->|"finds datasets"| node_catalog
node_coding_agent -.->|"requests notebook tools"| node_mcp_server
node_mcp_server -->|"connects proxy"| node_notebook_proxy
node_mcp_server -->|"dispatches create"| node_create_nb
node_mcp_server -->|"dispatches edits"| node_cell_ops
node_mcp_server -->|"dispatches reads"| node_read_ops
node_mcp_server -->|"dispatches listing"| node_list_ops
node_mcp_server -->|"dispatches search"| node_search_ops
node_mcp_server -->|"dispatches outputs"| node_output_ops
node_create_nb -->|"writes file"| node_notebook_files
node_cell_ops -->|"reads and writes"| node_notebook_files
node_read_ops -.->|"reads file"| node_notebook_files
node_list_ops -->|"reads file"| node_notebook_files
node_search_ops -->|"reads file"| node_notebook_files
node_output_ops -->|"reads file"| node_notebook_files
node_engineering -->|"builds cloud pipelines"| node_external_cloud
node_analysis -->|"queries cloud data"| node_external_cloud
node_bigquery_ml -->|"uses cloud ML"| node_external_cloud
node_airflow -.->|"monitors services"| node_external_cloud
node_spark_troubleshoot -->|"diagnoses jobs"| node_external_cloud
node_security_assessment -.->|"assesses resources"| node_external_cloud

click node_dak_skills "https://github.com/googlecloudplatform/data-agent-kit-plugin/tree/main/skills"
click node_setup "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/dak-setup/SKILL.md"
click node_mcp_server "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/server.ts"
click node_notebook_proxy "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/bin/mcp_proxy_bundle.cjs"
click node_create_nb "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/create_notebook.ts"
click node_cell_ops "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/insert_cell.ts"
click node_read_ops "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/read_cell.ts"
click node_list_ops "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/list_cells.ts"
click node_search_ops "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/search_cells.ts"
click node_output_ops "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/get_cell_outputs.ts"
click node_engineering "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcp-data-pipelines/SKILL.md"
click node_analysis "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/bigquery-sql/SKILL.md"
click node_bigquery_ml "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/bigquery-ai-ml/SKILL.md"
click node_notebook_guidance "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/notebook-guidance/SKILL.md"
click node_bigframes "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/bigquery-bigframes/SKILL.md"
click node_airflow "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcp-managed-airflow-recommendations/SKILL.md"
click node_spark_troubleshoot "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcp-spark-troubleshooting/SKILL.md"
click node_security_assessment "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcs-security-assessment/SKILL.md"
click node_catalog "https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/discovering-gcp-data-assets/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dak_skills,node_setup toneBlue
class node_mcp_server,node_notebook_proxy,node_create_nb,node_cell_ops,node_read_ops,node_list_ops,node_search_ops,node_output_ops,node_notebook_files toneAmber
class node_engineering,node_analysis,node_bigquery_ml,node_notebook_guidance,node_bigframes toneMint
class node_airflow,node_spark_troubleshoot,node_security_assessment,node_catalog toneRose
class node_user,node_coding_agent,node_external_cloud toneIndigo
```

## Components

### Agent integration

- [Data Agent Kit skills](https://github.com/googlecloudplatform/data-agent-kit-plugin/tree/main/skills): `skills`
- [Kit setup](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/dak-setup/SKILL.md): `skills/dak-setup/SKILL.md`

### Notebook tools

- [Notebook MCP server](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/server.ts): `mcp/server.ts`
- [Notebook and visualization proxy](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/bin/mcp_proxy_bundle.cjs): `mcp/bin/mcp_proxy_bundle.cjs`
- [Create notebook](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/create_notebook.ts): `mcp/tools/create_notebook.ts`
- [Cell editing](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/insert_cell.ts): `mcp/tools/insert_cell.ts`
- [Cell reading](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/read_cell.ts): `mcp/tools/read_cell.ts`
- [List cells](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/list_cells.ts): `mcp/tools/list_cells.ts`
- [Search cells](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/search_cells.ts): `mcp/tools/search_cells.ts`
- [Cell outputs](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/mcp/tools/get_cell_outputs.ts): `mcp/tools/get_cell_outputs.ts`
- **Jupyter notebook files**

### Data workflows

- [Data engineering](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcp-data-pipelines/SKILL.md): `skills/gcp-data-pipelines/SKILL.md`
- [Data analysis](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/bigquery-sql/SKILL.md): `skills/bigquery-sql/SKILL.md`
- [BigQuery AI and ML](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/bigquery-ai-ml/SKILL.md): `skills/bigquery-ai-ml/SKILL.md`
- [Notebook guidance](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/notebook-guidance/SKILL.md): `skills/notebook-guidance/SKILL.md`
- [BigQuery BigFrames](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/bigquery-bigframes/SKILL.md): `skills/bigquery-bigframes/SKILL.md`

### Cloud operations

- [Airflow recommendations](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcp-managed-airflow-recommendations/SKILL.md): `skills/gcp-managed-airflow-recommendations/SKILL.md`
- [Spark troubleshooting](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcp-spark-troubleshooting/SKILL.md): `skills/gcp-spark-troubleshooting/SKILL.md`
- [Storage security assessment](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/gcs-security-assessment/SKILL.md): `skills/gcs-security-assessment/SKILL.md`
- [Data asset discovery](https://github.com/googlecloudplatform/data-agent-kit-plugin/blob/main/skills/discovering-gcp-data-assets/SKILL.md): `skills/discovering-gcp-data-assets/SKILL.md`

### Other components

- **Data practitioner**
- **Coding agent**
- **Google Cloud services**

## Connections

- Data practitioner → Coding agent: prompts (evidence: `README.md`)
- Coding agent → Data Agent Kit skills: uses plugin (evidence: `README.md`)
- Coding agent → Kit setup: invokes setup (evidence: `README.md`)
- Data Agent Kit skills → Data engineering: supports pipelines (evidence: `README.md`)
- Data Agent Kit skills → Data analysis: supports analysis (evidence: `README.md`)
- Data Agent Kit skills → BigQuery AI and ML: supports ML (evidence: `README.md`)
- Data Agent Kit skills → Notebook guidance: guides notebooks (evidence: `README.md`)
- Data Agent Kit skills → BigQuery BigFrames: supports data science
- Data Agent Kit skills → Airflow recommendations: supports orchestration (evidence: `README.md`)
- Data Agent Kit skills → Spark troubleshooting: troubleshoots jobs (evidence: `README.md`)
- Data Agent Kit skills → Storage security assessment: assesses storage
- Data Agent Kit skills → Data asset discovery: finds datasets (evidence: `README.md`)
- Coding agent → Notebook MCP server: requests notebook tools
- Notebook MCP server → Notebook and visualization proxy: connects proxy (evidence: `mcp/server.ts`)
- Notebook MCP server → Create notebook: dispatches create (evidence: `mcp/server.ts`)
- Notebook MCP server → Cell editing: dispatches edits (evidence: `mcp/server.ts`)
- Notebook MCP server → Cell reading: dispatches reads (evidence: `mcp/server.ts`)
- Notebook MCP server → List cells: dispatches listing (evidence: `mcp/server.ts`)
- Notebook MCP server → Search cells: dispatches search (evidence: `mcp/server.ts`)
- Notebook MCP server → Cell outputs: dispatches outputs (evidence: `mcp/server.ts`)
- Create notebook → Jupyter notebook files: writes file (evidence: `mcp/tools/create_notebook.ts`)
- Cell editing → Jupyter notebook files: reads and writes (evidence: `mcp/tools/insert_cell.ts`)
- Cell reading → Jupyter notebook files: reads file
- List cells → Jupyter notebook files: reads file (evidence: `mcp/tools/list_cells.ts`)
- Search cells → Jupyter notebook files: reads file (evidence: `mcp/tools/search_cells.ts`)
- Cell outputs → Jupyter notebook files: reads file (evidence: `mcp/tools/get_cell_outputs.ts`)
- Data engineering → Google Cloud services: builds cloud pipelines (evidence: `README.md`)
- Data analysis → Google Cloud services: queries cloud data (evidence: `README.md`)
- BigQuery AI and ML → Google Cloud services: uses cloud ML (evidence: `README.md`)
- Airflow recommendations → Google Cloud services: monitors services
- Spark troubleshooting → Google Cloud services: diagnoses jobs (evidence: `README.md`)
- Storage security assessment → Google Cloud services: assesses resources
