Skip to main content

Gcp/agentregistry

@swamp/gcp/agentregistryv2026.10.25.1· AGPL-3.0-or-later· 1d agoBEHAVIORS
01README

Google Cloud agentregistry infrastructure models

02Release Notes
  • Added: findings, publishers, skills, skills_revisions
03Behaviors14
@swamp/gcp/agentregistry/agentsv2026.10.23.1agents.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a agents
ArgumentTypeDescription
identifierstringThe name of the agents
fn sync(identifier?: string)
Sync agents state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific agents by name (e.g. one discovered by list)
fn list(filter?: string, orderBy?: string, pageSize?: number, maxPages?: number)
List agents resources
ArgumentTypeDescription
filter?stringOptional. Filtering results
orderBy?stringOptional. Hint for how to order the results
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)
fn search(pageSize?: any, pageToken?: any, searchString?: any)
search
ArgumentTypeDescription
pageSize?any
pageToken?any
searchString?any

Resources

state(infinite)— Represents an Agent. "A2A" below refers to the Agent-to-Agent protocol.
@swamp/gcp/agentregistry/aiapplicationsv2026.10.23.1aiapplications.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a aiApplications
ArgumentTypeDescription
identifierstringThe name of the aiApplications
fn sync(identifier?: string)
Sync aiApplications state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific aiApplications by name (e.g. one discovered by list)
fn list(filter?: string, orderBy?: string, pageSize?: number, maxPages?: number)
List aiApplications resources
ArgumentTypeDescription
filter?stringOptional. Filtering results.
orderBy?stringOptional. Hint for how to order the results.
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)
fn get_iam_policy(options_requestedPolicyVersion?: any)
get iam policy
ArgumentTypeDescription
options_requestedPolicyVersion?any
fn set_iam_policy(policy?: any, updateMask?: any)
set iam policy
ArgumentTypeDescription
policy?any
updateMask?any
fn test_iam_permissions(permissions?: any)
test iam permissions
ArgumentTypeDescription
permissions?any

Resources

state(infinite)— Represents an AI Application.
@swamp/gcp/agentregistry/aiapplications-agentsv2026.10.23.1aiapplications_agents.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
parent?stringThe parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a agents
ArgumentTypeDescription
identifierstringThe name of the agents
fn sync(identifier?: string)
Sync agents state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific agents by name (e.g. one discovered by list)
fn list(pageSize?: number, maxPages?: number)
List agents resources
ArgumentTypeDescription
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents an Agent. "A2A" below refers to the Agent-to-Agent protocol.
@swamp/gcp/agentregistry/aiapplications-endpointsv2026.10.23.1aiapplications_endpoints.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
parent?stringThe parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a endpoints
ArgumentTypeDescription
identifierstringThe name of the endpoints
fn sync(identifier?: string)
Sync endpoints state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific endpoints by name (e.g. one discovered by list)
fn list(pageSize?: number, maxPages?: number)
List endpoints resources
ArgumentTypeDescription
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents an Endpoint.
@swamp/gcp/agentregistry/aiapplications-mcpserversv2026.10.23.1aiapplications_mcpservers.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
parent?stringThe parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a mcpServers
ArgumentTypeDescription
identifierstringThe name of the mcpServers
fn sync(identifier?: string)
Sync mcpServers state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific mcpServers by name (e.g. one discovered by list)
fn list(pageSize?: number, maxPages?: number)
List mcpServers resources
ArgumentTypeDescription
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents an MCP (Model Context Protocol) Server.
@swamp/gcp/agentregistry/bindingsv2026.10.23.1bindings.ts

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
authProviderBinding?objectThe binding for AuthProvider.
description?stringOptional. User-defined description of a Binding. Can have a maximum length of `2048` characters.
displayName?stringOptional. User-defined display name for the Binding. Can have a maximum length of `63` characters.
name?stringRequired. Identifier. The resource name of the Binding. Format: `projects/{project}/locations/{location}/bindings/{binding}`.
source?objectOptional. The source Agent of the Binding.
target?objectRequired. The target Agent Registry Resource of the Binding.
bindingId?stringRequired. The ID to use for the binding, which will become the final component of the binding's resource name. This value should be 4-63 characters, and must conform to RFC-1034. Specifically, it must match the regular expression `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
requestId?stringOptional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID w
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn create()
Create a bindings
fn get(identifier: string)
Get a bindings
ArgumentTypeDescription
identifierstringThe name of the bindings
fn update(identifier?: string)
Update bindings attributes
ArgumentTypeDescription
identifier?stringTarget a specific bindings by name (e.g. one discovered by list)
fn delete(identifier: string)
Delete the bindings
ArgumentTypeDescription
identifierstringThe name of the bindings
fn sync(identifier?: string)
Sync bindings state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific bindings by name (e.g. one discovered by list)
fn list(filter?: string, orderBy?: string, pageSize?: number, maxPages?: number)
List bindings resources
ArgumentTypeDescription
filter?stringOptional. A query string used to filter the list of bindings returned. The filter expression must follow AIP-160 syntax.
orderBy?stringOptional. Hint for how to order the results
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. Page size is 500 if unspecified and is capped at `500` even if a larger value is given.
maxPages?numberMaximum number of pages to fetch (default: 10)
fn fetch_available(pageSize?: any, pageToken?: any, sourceIdentifier?: any, targetIdentifier?: any)
fetch available
ArgumentTypeDescription
pageSize?any
pageToken?any
sourceIdentifier?any
targetIdentifier?any

Resources

state(infinite)— Represents a user-defined Binding.
@swamp/gcp/agentregistry/endpointsv2026.10.23.1endpoints.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a endpoints
ArgumentTypeDescription
identifierstringThe name of the endpoints
fn sync(identifier?: string)
Sync endpoints state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific endpoints by name (e.g. one discovered by list)
fn list(filter?: string, pageSize?: number, maxPages?: number)
List endpoints resources
ArgumentTypeDescription
filter?stringOptional. A query string used to filter the list of endpoints returned. The filter expression must follow AIP-160 syntax. Filtering is supported on the `name`, `display_name`, `description`, `version`, and `interfaces` fields. Some examples: * `name = "projects/p1/locations/l1/endpoints/e1"` * `display_name = "my-endpoint"` * `description = "my-endpoint-description"` * `version = "v1"` * `interfaces.transport = "HTTP_JSON"`
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents an Endpoint.
@swamp/gcp/agentregistry/findingsv2026.10.25.1findings.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a findings
ArgumentTypeDescription
identifierstringThe name of the findings
fn sync(identifier?: string)
Sync findings state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific findings by name (e.g. one discovered by list)
fn list(filter?: string, orderBy?: string, pageSize?: number, maxPages?: number)
List findings resources
ArgumentTypeDescription
filter?stringOptional. Filtering results
orderBy?stringOptional. Hint for how to order the results
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents a security Finding.
@swamp/gcp/agentregistry/locationsv2026.10.23.1locations.ts

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
namestringThe resource that owns the locations collection, if applicable.
fn get(identifier: string)
Get a locations
ArgumentTypeDescription
identifierstringThe name of the locations
fn sync(identifier?: string)
Sync locations state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific locations by name (e.g. one discovered by list)
fn list(extraLocationTypes?: string, filter?: string, pageSize?: number, maxPages?: number)
List locations resources
ArgumentTypeDescription
extraLocationTypes?stringOptional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.
filter?stringA filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
pageSize?numberThe maximum number of results to return. If not set, the service selects a default.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— A resource that represents a Google Cloud location.
@swamp/gcp/agentregistry/mcpserversv2026.10.23.1mcpservers.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a mcpServers
ArgumentTypeDescription
identifierstringThe name of the mcpServers
fn sync(identifier?: string)
Sync mcpServers state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific mcpServers by name (e.g. one discovered by list)
fn list(filter?: string, orderBy?: string, pageSize?: number, maxPages?: number)
List mcpServers resources
ArgumentTypeDescription
filter?stringOptional. Filtering results
orderBy?stringOptional. Hint for how to order the results
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)
fn search(pageSize?: any, pageToken?: any, searchString?: any)
search
ArgumentTypeDescription
pageSize?any
pageToken?any
searchString?any

Resources

state(infinite)— Represents an MCP (Model Context Protocol) Server.
@swamp/gcp/agentregistry/publishersv2026.10.25.1publishers.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn get(identifier: string)
Get a publishers
ArgumentTypeDescription
identifierstringThe name of the publishers
fn sync(identifier?: string)
Sync publishers state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific publishers by name (e.g. one discovered by list)
fn list(pageSize?: number, maxPages?: number)
List publishers resources
ArgumentTypeDescription
pageSize?numberOptional. Page limit size.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents a verified Publisher of Skills. Prepopulated publishers include `p...
@swamp/gcp/agentregistry/servicesv2026.10.23.1services.ts

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
agentSpec?objectOptional. The spec of the Agent. When `agent_spec` is set, the type of the service is Agent.
description?stringOptional. User-defined description of an Service. Can have a maximum length of `2048` characters.
displayName?stringOptional. User-defined display name for the Service. Can have a maximum length of `63` characters.
endpointSpec?objectOptional. The spec of the Endpoint. When `endpoint_spec` is set, the type of the service is Endpoint.
interfaces?arrayOptional. The connection details for the Service.
mcpServerSpec?objectOptional. The spec of the MCP Server. When `mcp_server_spec` is set, the type of the service is MCP Server.
name?stringIdentifier. The resource name of the Service. Format: `projects/{project}/locations/{location}/services/{service}`.
requestId?stringOptional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID w
serviceId?stringRequired. The ID to use for the service, which will become the final component of the service's resource name. This value should be 4-63 characters, and valid characters are `/a-z-/`.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn create()
Create a services
fn get(identifier: string)
Get a services
ArgumentTypeDescription
identifierstringThe name of the services
fn update(identifier?: string)
Update services attributes
ArgumentTypeDescription
identifier?stringTarget a specific services by name (e.g. one discovered by list)
fn delete(identifier: string)
Delete the services
ArgumentTypeDescription
identifierstringThe name of the services
fn sync(identifier?: string)
Sync services state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific services by name (e.g. one discovered by list)
fn list(filter?: string, pageSize?: number, maxPages?: number)
List services resources
ArgumentTypeDescription
filter?stringOptional. A query string used to filter the list of services returned. The filter expression must follow AIP-160 syntax. Filtering is supported on the `name`, `display_name`, `description`, and `labels` fields. Some examples: * `name = "projects/p1/locations/l1/services/s1"` * `display_name = "my-service"` * `description : "myservice description"` * `labels.env = "prod"`
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents a user-defined Service.
@swamp/gcp/agentregistry/skillsv2026.10.25.1skills.ts

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
defaultRevision?stringOptional. The full resource name of the revision currently served by default (floating track). Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`
description?stringOptional. Brief summary describing the capabilities of the skill. Maximum length is 2048 characters.
displayName?stringRequired. Human-readable display name of the skill. Maximum length is 128 characters.
initialRevision?objectOptional. Input only. Optional nested initial revision payload to support standard one-shot creation. The server processes this field on input during creation but must never return it in responses.
name?stringIdentifier. Resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}` The `{skill}` segment acts as the resource ID. If the skill is associated with a Publisher, this segment typically uses a hyphenated namespace prefix corresponding to the publisher (e.g., `google-workspace-create-docs`).
publisher?stringOptional. The publisher resource associated with this skill. Format: `projects/{project}/locations/{location}/publishers/{publisher}` The publisher dictates the allowed namespace prefixes for the skill's name and logical `skill_id` (e.g., Publisher `google` authorizes the `google-*` prefix).
scanningConfig?objectOptional. Optional. Scanning configuration for the skill.
targetState?enumRequired. User-managed target state of the skill.
type?enumRequired. Structural deployment type (SIMPLE leaf vs COMPOSITE bundle).
requestId?stringOptional. Signed UUID request idempotency token.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn create()
Create a skills
fn get(identifier: string)
Get a skills
ArgumentTypeDescription
identifierstringThe name of the skills
fn update(identifier?: string)
Update skills attributes
ArgumentTypeDescription
identifier?stringTarget a specific skills by name (e.g. one discovered by list)
fn delete(identifier: string)
Delete the skills
ArgumentTypeDescription
identifierstringThe name of the skills
fn sync(identifier?: string)
Sync skills state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific skills by name (e.g. one discovered by list)
fn list(filter?: string, orderBy?: string, pageSize?: number, maxPages?: number)
List skills resources
ArgumentTypeDescription
filter?stringOptional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | upd
orderBy?stringOptional. Hint for how to order the results
pageSize?numberOptional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
maxPages?numberMaximum number of pages to fetch (default: 10)
fn get_iam_policy(options_requestedPolicyVersion?: any)
get iam policy
ArgumentTypeDescription
options_requestedPolicyVersion?any
fn search(filter?: any, pageSize?: any, pageToken?: any, searchString?: any, searchType?: any)
search
ArgumentTypeDescription
filter?any
pageSize?any
pageToken?any
searchString?any
searchType?any
fn set_iam_policy(policy?: any, updateMask?: any)
set iam policy
ArgumentTypeDescription
policy?any
updateMask?any
fn test_iam_permissions(permissions?: any)
test iam permissions
ArgumentTypeDescription
permissions?any

Resources

state(infinite)— Represents an Executable Agent Skill or a Composite Tool Suite (Bundle). Sibl...
@swamp/gcp/agentregistry/skills-revisionsv2026.10.25.1skills_revisions.ts

Global Arguments

ArgumentTypeDescription
accessToken?stringGCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?stringGCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?stringGCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?stringComma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?stringGCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?stringCustom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
archiveUploadSource?objectOptional. Immutable. Direct write-only raw archive upload source.
gcsSource?objectOptional. Immutable. Cloud Storage object generation URI.
name?stringIdentifier. Resource name of the SkillRevision. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`
requestId?stringOptional. Signed UUID request idempotency token.
skillRevisionId?stringOptional. Custom, user-defined unique revision identifier. Format: 4-63 characters, matching regex `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`
parent?stringThe parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
fn create(waitForReady?: boolean)
Create a revisions
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
fn get(identifier: string)
Get a revisions
ArgumentTypeDescription
identifierstringThe name of the revisions
fn delete(identifier: string)
Delete the revisions
ArgumentTypeDescription
identifierstringThe name of the revisions
fn sync(identifier?: string)
Sync revisions state from GCP
ArgumentTypeDescription
identifier?stringTarget a specific revisions by name (e.g. one discovered by list)
fn list(pageSize?: number, maxPages?: number)
List revisions resources
ArgumentTypeDescription
pageSize?numberOptional. Page limit size.
maxPages?numberMaximum number of pages to fetch (default: 10)

Resources

state(infinite)— Represents an immutable, versioned snapshot of a Skill package.
04Previous Versions19
2026.10.23.1AGPL-3.0-or-later(was none)
  • Updated: locations, agents, aiapplications, aiapplications_agents, aiapplications_endpoints, aiapplications_mcpservers, bindings, endpoints, mcpservers, services
2026.10.13.1
  • Updated: locations, agents, aiapplications, aiapplications_agents, aiapplications_endpoints, aiapplications_mcpservers, bindings, endpoints, mcpservers, services

Added 4 behaviors

2026.09.07.1
  • Updated: bindings
2026.08.12.2
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.07.29.1
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.07.21.4
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.07.21.1
  • Updated: bindings, services
2026.07.20.2
  • Added: bindings
  • Updated: locations, agents, endpoints, mcpservers, services

Added 1, modified 2 behaviors

2026.07.20.1
  • Updated: locations, agents, endpoints, mcpservers, services

Removed 1, modified 2 behaviors

2026.07.19.2
  • Updated: locations
2026.07.19.1
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.07.18.2
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.07.17.2
  • Updated: bindings, services
2026.07.17.1
  • Updated: agents, bindings, endpoints, mcpservers, services
2026.06.26.1
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.06.08.2
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.06.07.1
  • Updated: locations, agents, bindings, endpoints, mcpservers, services
2026.05.26.1
  • Added: bindings
  • Updated: locations, agents, mcpservers

Added 1, modified 2 behaviors

2026.05.25.1
  • Updated: locations, agents, endpoints, mcpservers, services

Removed 1, modified 5 behaviors

05Stats
A
100 / 100
Downloads
33
Archive size
92.6 KB
Verified by Swamp
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels