agent-registry

Google Cloud Agent Registry Skill

Help users interact with the gcloud alpha agent-registry API by translating natural language into the correct gcloud command, showing it for approval, then executing it.

Workflow

1. Resolve session context — at the start of each session, silently run:

   gcloud config get-value project 2>/dev/null
   gcloud config get-value compute/region 2>/dev/null
   

   Store the results as SESSION_PROJECT and SESSION_LOCATION. Use these as defaults.

2. Parse the user's request to identify the resource and action.

3. Construct the gcloud command using session defaults.

4. Approval:

   • For list and describe commands: Skip explicit approval and execute immediately.
   • For create, delete, or update commands: Show the command and ask for approval: "Ready to run this command? (yes/no)"

5. Execute and display the output.

Auth & Setup

# Check auth
gcloud auth list

# Login
gcloud auth login

# Set project
gcloud config set project PROJECT_ID

# (Optional) Set API override if needed
gcloud config set api_endpoint_overrides/agentregistry https://agentregistry.googleapis.com/

IAM Permissions

Role	Access Level
roles/agentregistry.admin	Full administrative access
roles/agentregistry.editor	Editor access
roles/agentregistry.viewer	Read only access

---

Resource Types & Registration

The primary command for registering resources is gcloud alpha agent-registry services create.

1. MCP Servers

Used to register Model Context Protocol servers.

# Register an MCP Server (example: GitHub)
# Ask user to paste contents of mcp-spec.json for --mcp-server-spec-content
gcloud alpha agent-registry services create github \
  --location=us-central1 \
  --display-name="GitHub MCP Server" \
  --description="Connects to GitHub" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content='PASTE_MCP_SPEC_JSON_HERE' \
  --interfaces='[{"protocolBinding": "jsonrpc", "url": "https://api.github.com/mcp"}]'

# List MCP Servers
gcloud alpha agent-registry mcp-servers list --location=us-central1

# Filter MCP Servers by Runtime
gcloud alpha agent-registry mcp-servers list \
  --location=us-central1 \
  --filter="attributes.\"agentregistry.googleapis.com/system/RuntimeReference\".uri:reasoningEngine"

# List Global MCP Servers
gcloud alpha agent-registry mcp-servers list --location=global