feat(plugin): migrate from generated skills to the prebuilt MCP server (#126)

Author: wangauone

.claude-plugin/marketplace.json

@@ -5,12 +5,12 @@
     "email": "data-cloud-ai-integrations@google.com"
   },
   "metadata": {
-    "description": "Agent skills for Cloud SQL for SQL Server to query, manage, and monitor databases."
+    "description": "Connect to and interact with a Cloud SQL for SQL Server database."
   },
   "plugins": [
     {
       "name": "cloud-sql-sqlserver",
       "source": "./"
     }
   ]
-}
+}

.claude-plugin/plugin.json

@@ -7,7 +7,71 @@
     "email": "data-cloud-ai-integrations@google.com"
   },
   "homepage": "https://cloud.google.com/sql/docs/sqlserver",
-  "license": "Apache-2.0",
   "repository": "https://github.com/gemini-cli-extensions/cloud-sql-sqlserver",
-  "skills": "./skills/"
+  "license": "Apache-2.0",
+  "userConfig": {
+    "cloud_sql_mssql_project": {
+      "title": "Project Name",
+      "description": "Name of the Google Cloud project",
+      "type": "string",
+      "sensitive": false
+    },
+    "cloud_sql_mssql_region": {
+      "title": "Region",
+      "description": "Region of the Cloud SQL instance",
+      "type": "string",
+      "sensitive": false
+    },
+    "cloud_sql_mssql_instance": {
+      "title": "Instance ID",
+      "description": "ID of the Cloud SQL instance",
+      "type": "string",
+      "sensitive": false
+    },
+    "cloud_sql_mssql_database": {
+      "title": "Database",
+      "description": "Name of the database",
+      "type": "string",
+      "sensitive": false
+    },
+    "cloud_sql_mssql_user": {
+      "title": "User",
+      "description": "Username of the database user",
+      "type": "string",
+      "sensitive": false
+    },
+    "cloud_sql_mssql_password": {
+      "title": "Password",
+      "description": "Password of the database user",
+      "type": "string",
+      "sensitive": false
+    },
+    "cloud_sql_mssql_ip_type": {
+      "title": "Instance IP assignment",
+      "description": "(Optional) Type of the IP address: PUBLIC, PRIVATE, or PSC (Default: Public)",
+      "type": "string",
+      "sensitive": false
+    }
+  },
+  "mcpServers": {
+    "cloud-sql-mssql": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@toolbox-sdk/server@1.9.0",
+        "--prebuilt",
+        "cloud-sql-mssql",
+        "--stdio"
+      ],
+      "env": {
+        "CLOUD_SQL_MSSQL_PROJECT": "${user_config.cloud_sql_mssql_project}",
+        "CLOUD_SQL_MSSQL_REGION": "${user_config.cloud_sql_mssql_region}",
+        "CLOUD_SQL_MSSQL_INSTANCE": "${user_config.cloud_sql_mssql_instance}",
+        "CLOUD_SQL_MSSQL_DATABASE": "${user_config.cloud_sql_mssql_database}",
+        "CLOUD_SQL_MSSQL_USER": "${user_config.cloud_sql_mssql_user}",
+        "CLOUD_SQL_MSSQL_PASSWORD": "${user_config.cloud_sql_mssql_password}",
+        "CLOUD_SQL_MSSQL_IP_TYPE": "${user_config.cloud_sql_mssql_ip_type}"
+      }
+    }
+  }
 }

.codex-plugin/.mcp.json

@@ -0,0 +1,23 @@
+{
+  "mcpServers": {
+    "cloud-sql-mssql": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@toolbox-sdk/server@1.9.0",
+        "--prebuilt",
+        "cloud-sql-mssql",
+        "--stdio"
+      ],
+      "env_vars": [
+        "CLOUD_SQL_MSSQL_PROJECT",
+        "CLOUD_SQL_MSSQL_REGION",
+        "CLOUD_SQL_MSSQL_INSTANCE",
+        "CLOUD_SQL_MSSQL_DATABASE",
+        "CLOUD_SQL_MSSQL_USER",
+        "CLOUD_SQL_MSSQL_PASSWORD",
+        "CLOUD_SQL_MSSQL_IP_TYPE"
+      ]
+    }
+  }
+}

.codex-plugin/plugin.json

@@ -14,7 +14,6 @@
     "sql-server",
     "database"
   ],
-  "skills": "./skills/",
   "interface": {
     "displayName": "Cloud SQL for SQL Server",
     "shortDescription": "Interact with CloudSQL for SQL Server instances.",
@@ -27,5 +26,6 @@
     "defaultPrompt": [
       "You are a highly skilled database engineer and database administrator. Your purpose is to help the developer build and interact with databases and utilize data context throughout the entire software delivery cycle."
     ]
-  }
-}
+  },
+  "mcpServers": "./.codex-plugin/.mcp.json"
+}

.github/renovate.json5

@@ -21,18 +21,28 @@
       pinDigests: true,
     },
     {
-      matchPackageNames: ['googleapis/mcp-toolbox'],
+      matchPackageNames: ['@toolbox-sdk/server'],
+      // Group the toolbox update under a stable branch name (renovate/toolbox).
+      groupName: 'toolbox',
       'semanticCommitType': 'feat'
     }
   ],
   customManagers: [
     {
+      // Track the npm toolbox server pinned in the MCP command. The version is
+      // listed in the source (mcp.json) and repeated in every generated
+      // manifest, so all of them are bumped in one PR.
       customType: "regex",
-      managerFilePatterns: ["/toolbox_version\\.txt$/"],
-      matchStrings: ["(?<currentValue>[\\d\\.]+)"],
-      datasourceTemplate: "github-releases",
-      packageNameTemplate: "googleapis/mcp-toolbox",
-      extractVersionTemplate: "^v(?<version>.*)$",
+      managerFilePatterns: [
+        "/mcp\.json$/",
+        "/mcp_config\.json$/",
+        "/gemini-extension\.json$/",
+        "/\.claude-plugin/plugin\.json$/",
+        "/\.codex-plugin/\.mcp\.json$/",
+      ],
+      matchStrings: ["@toolbox-sdk/server@(?<currentValue>[\d\.]+)"],
+      datasourceTemplate: "npm",
+      depNameTemplate: "@toolbox-sdk/server",
     }
   ]
 }

.github/workflows/presubmit-tests.yml

@@ -17,22 +17,19 @@ on:
   pull_request:
     branches: [ main ]
 
+permissions:
+  contents: read
+
 jobs:
   run-presubmit-tests:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Gemini CLI
         run: npm install @google/gemini-cli
 
-      - name: Install toolbox binary
-        run: |
-          VERSION=$(cat toolbox_version.txt)
-          curl -L -o toolbox "https://storage.googleapis.com/mcp-toolbox-for-databases/v${VERSION}/linux/amd64/toolbox"
-          chmod +x toolbox
-
       - name: Install Extension
         run: npx gemini extensions validate .
         env:

README.md

@@ -1,9 +1,9 @@
-# Cloud SQL for SQL Server Agent Skills
+# Cloud SQL for SQL Server
 
 > [!NOTE]
 > This extension is currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0).
 
-This repository provides a set of agent skills to interact with [Cloud SQL for SQL Server](https://cloud.google.com/sql/docs/sqlserver) instances. These skills can be used with various AI agents, including [Antigravity](https://antigravity.google/), [Claude Code](https://claude.com/product/claude-code) and [Codex](https://developers.openai.com/codex), to manage your databases, execute queries, explore schemas, and troubleshoot issues using natural language prompts.
+This repository packages [MCP Toolbox](https://github.com/googleapis/mcp-toolbox)'s prebuilt `cloud-sql-mssql` server as a plugin/extension to interact with [Cloud SQL for SQL Server](https://cloud.google.com/sql/docs/sqlserver) instances. It can be used with various AI agents, including [Antigravity](https://antigravity.google/), [Claude Code](https://claude.com/product/claude-code) and [Codex](https://developers.openai.com/codex), to manage your databases, execute queries, explore schemas, and troubleshoot issues using natural language prompts.
 
 > [!IMPORTANT]
 > **We Want Your Feedback!**
@@ -14,22 +14,22 @@ This repository provides a set of agent skills to interact with [Cloud SQL for S
 
 ## Table of Contents
 
-- [Why Use Cloud SQL for SQL Server Agent Skills?](#why-use-cloud-sql-for-sql-server-agent-skills)
+- [Why Use Cloud SQL for SQL Server?](#why-use-cloud-sql-for-sql-server)
 - [Prerequisites](#prerequisites)
 - [Getting Started](#getting-started)
   - [Configuration](#configuration)
   - [Installation & Usage](#installation--usage)
     - [Antigravity](#antigravity)
     - [Claude Code](#claude-code)
     - [Codex](#codex)
-- [Installing using open agent skills tool](#installing-using-open-agent-skills-tool)
 - [Installing via a compatible Agent Plugins client](#installing-via-a-compatible-agent-plugins-client)
 - [Usage Examples](#usage-examples)
-- [Supported Skills](#supported-skills)
+- [Available Tools](#available-tools)
+- [Generating Skills Instead](#generating-skills-instead)
 - [Additional Agent Skills](#additional-agent-skills)
 - [Troubleshooting](#troubleshooting)
 
-## Why Use Cloud SQL for SQL Server Agent Skills?
+## Why Use Cloud SQL for SQL Server?
 
 - **Seamless Workflow:** Integrates seamlessly into your AI agent's environment. No need to constantly switch contexts for common database tasks.
 - **Natural Language Queries:** Stop wrestling with complex commands. Explore schemas and query data by describing what you want in plain English.
@@ -46,6 +46,7 @@ Before you begin, ensure you have the following:
      - [Antigravity 2.0](https://antigravity.google/product/antigravity-2) version **v2.0.0** or higher.
   - [Claude Code](https://claude.com/product/claude-code) version **v2.1.94** or higher.
   - [Codex](https://developers.openai.com/codex) **v0.117.0** or higher.
+- [Node.js](https://nodejs.org/) — the MCP server runs via `npx`.
 - A Google Cloud project with the **Cloud SQL Admin API** enabled.
 - Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
 - IAM Permissions:
@@ -75,7 +76,7 @@ Please keep these env vars handy during the installation process:
 
 ### Installation & Usage
 
-To start interacting with your database, install the skills for your preferred AI agent, then launch the agent and use natural language to ask questions or perform tasks.
+To start interacting with your database, install the extension for your preferred AI agent, then launch the agent and use natural language to ask questions or perform tasks.
 
 For the latest version, check the [releases page][releases].
 
@@ -104,28 +105,18 @@ See <a href="https://antigravity.google/docs/gcli-migration">Migrating from Gemi
 
 #### Antigravity 2.0 (IDE)
 
-**1. Clone the Repo:**
-
-```bash
-git clone --branch 0.2.0 https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git
-```
-
-**2. Install the skills:**
-
-Choose a location for the skills:
-- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
-- **Workspace-specific:** `<workspace-root>/.agents/skills/`
+**1. Install the plugin:**
 
-Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
+Install the plugin directly from the remote GitHub repository:
 
 ```bash
-cp -R cloud-sql-sqlserver/skills/* ~/.gemini/antigravity/skills/
+agy plugin install https://github.com/gemini-cli-extensions/cloud-sql-sqlserver
 ```
 
-**3. Set env vars:**
+**2. Set env vars:**
 Set your environment vars as described in the [configuration section](#configuration).
 
-_(Tip: Antigravity 2.0 automatically discovers skills in these directories at the start of a session. You can verify they are active by running the `/skills` command in your active session.)_
+_(Tip: You can verify the MCP server is active by running the `/mcp` command in your active session.)_
 
 #### Antigravity CLI
 
@@ -160,8 +151,7 @@ claude
 /plugin install cloud-sql-sqlserver@claude-plugins-official
 ```
 
-_(Tip: Run `/plugin list` inside Claude Code to verify the plugin is active, or `/reload-plugins` if you just installed it.)_
-
+_(Tip: Run `/plugin list` inside Claude Code to verify the plugin is active, or `/reload-plugins` if you just installed it.)
 </details>
 
 <details>
@@ -189,23 +179,7 @@ codex plugin marketplace upgrade data-agent-kit
 
 </details>
 
-## Installing using [open agent skills tool](https://github.com/vercel-labs/skills)
-
-You can install skills using the `npx skills` command.
-
-**1. Install the skills:**
-
-Run the following command in your terminal to automatically download and register the skills:
-
-```bash
-npx skills add https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/tree/0.2.0
-```
-
-For detailed info check out the [Skills npm package](https://www.npmjs.com/package/skills).
-
-**2. Set env vars:**
-Set your environment vars as described in the [configuration section](#configuration).
-
+## Installing via a compatible Agent Plugins client
 ## Installing via a compatible Agent Plugins client
 
 This repository is a valid [Agent Plugins](https://github.com/agentplugins/agent-plugins-spec) (v1) plugin. Any [Agent Plugins–compatible client](https://agent-plugins.org/compatible-clients) can install it directly using its own built-in plugin command — no extra tooling required — by pointing at this repository:
@@ -235,14 +209,41 @@ Interact with Cloud SQL for SQL Server using natural language:
 - **Generate Code:**
   - "Generate a Python dataclass to represent the 'customers' table."
 
-## Supported Skills
+## Available Tools
+
+The tools come from MCP Toolbox's prebuilt `cloud-sql-mssql` server, grouped into toolsets:
+
+- **admin** - Use these tools when you need to provision new Cloud SQL for SQL Server instances, create databases and users, and monitor the progress of long-running operations.
+- **data** - Use these tools when you need to explore the database schema and execute SQL queries to interact with your data.
+- **monitor** - Use these tools when you need to troubleshoot slow queries and analyze system-level PromQL metrics.
+- **lifecycle** - Use these tools when you need to manage the lifecycle and durability of your data, including creating backups, restoring from existing backups, and cloning instances for testing or migration.
+
+For the full, up-to-date list, see the [`cloud-sql-mssql` prebuilt config](https://github.com/googleapis/mcp-toolbox/blob/main/internal/prebuiltconfigs/tools/cloud-sql-mssql.yaml)
+in the MCP Toolbox repository.
 
-The following skills are available in this repository:
+## Generating Skills Instead
+
+The tool-backed skills this plugin used to ship were generated from the same prebuilt
+toolsets. If your agent lacks deferred tool loading, or you prefer skills, regenerate
+them with the script in this repository:
+
+```bash
+VERSION=<toolbox version> ./.github/scripts/generate_skills.sh
+```
+
+Use the toolbox version pinned in [`mcp.json`](./mcp.json). A single toolset, without
+the script:
+
+```bash
+npx @toolbox-sdk/server@<toolbox version> --prebuilt cloud-sql-mssql skills-generate \
+  --name "<skill name>" \
+  --toolset "<toolset>" \
+  --description "<what it is for>"
+```
 
-- [Cloud SQL for SQL Server Admin](./skills/cloud-sql-sqlserver-admin/SKILL.md) - Use these skills when you need to provision new Cloud SQL for SQL Server instances, create databases and users, clone existing environments, and monitor the progress of long-running operations.
-- [Cloud SQL for SQL Server Data](./skills/cloud-sql-sqlserver-data/SKILL.md) - Use these skills when you need to explore the database schema, execute SQL queries to interact with your data, and monitor system-level performance metrics using PromQL queries.
-- [Cloud SQL for SQL Server Lifecycle](./skills/cloud-sql-sqlserver-lifecycle/SKILL.md) - Use these skills when you need to manage the lifecycle and durability of your data, including creating backups, restoring from existing backups, and cloning instances for testing or migration.
-- [Cloud SQL for SQL Server Monitor](./skills/cloud-sql-sqlserver-monitor/SKILL.md) - Use these skills when you need to troubleshoot slow queries and analyze system-level PromQL metrics.
+The generated scripts call the toolbox through `npx`, so no binary download is needed.
+See [Generate Agent Skills](https://github.com/googleapis/mcp-toolbox#generate-agent-skills)
+in the MCP Toolbox repository.
 
 ## Additional Agent Skills
 

gemini-extension.json

@@ -2,6 +2,18 @@
   "name": "cloud-sql-sqlserver",
   "version": "0.2.0",
   "description": "Connect to Cloud SQL for SQL Server",
+  "mcpServers": {
+    "cloud-sql-mssql": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@toolbox-sdk/server@1.9.0",
+        "--prebuilt",
+        "cloud-sql-mssql",
+        "--stdio"
+      ]
+    }
+  },
   "contextFileName": "CLOUD-SQL-SQLSERVER.md",
   "settings": [
     {