gcp-connector

Query read-only GCP inventory and logs for Cloud Run, Cloud SQL, Pub/Sub, and Logging.

10|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/narailabs/narai-primitives --skill gcp-connector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gcp-connector
Source: https://github.com/narailabs/narai-primitives/tree/main/plugins/gcp-connector/skills/gcp-connector
Command: npx skills add https://github.com/narailabs/narai-primitives --skill gcp-connector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps users answer operational and investigative questions about their GCP environment without needing to manually run and manage GCP CLI commands.

Core Features & Use Cases

  • Read-only GCP inventory queries: List Cloud Run services, Cloud SQL instances, Pub/Sub topics, and retrieve Cloud Logging entries scoped to a single project.
  • Targeted diagnostics: Describe a database instance (with optional database selection) to quickly validate what exists in the environment.
  • Use case: When you need to confirm what services or topics exist in project acme-prod-123, or review the most recent log events matching a filter, you can query it directly and safely.

Quick Start

Use the gcp-connector action list_services with params set to a JSON object containing your project_id to get the available services for that project.

Frequently Asked Questions about gcp-connector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list Cloud Run services and Pub/Sub topics for a specific GCP project?

To list Cloud Run services and Pub/Sub topics, you query read-only GCP inventory by providing your project_id. The connector executes permitted gcloud sub-commands and returns available services or topics scoped to that single project.

Can I retrieve Cloud Logging entries with time and result limits for investigation?

Yes, you can retrieve Cloud Logging entries with specific time and result limits. This allows you to query scoped log entries for investigation and reporting without manually managing the GCP CLI.

Does the GCP inventory connector allow mutating operations or write commands?

No, the GCP inventory connector does not allow mutating operations. It enforces safety by whitelisting permitted gcloud sub-commands and refusing any write commands to ensure strictly read-only queries.

What is the best way to describe a Cloud SQL instance safely within a project?

The best way to describe a Cloud SQL instance safely is to use targeted diagnostics with an optional database selection. This quickly validates what exists in the environment using read-only queries scoped to your project.

How does the connector execute and return GCP CLI query results?

The connector executes the gcp-connector binary with action and params JSON, then returns a stdout JSON envelope verbatim. This mechanism directly outputs your requested GCP inventory and log query results.