GCP.AgentRegistry reference

Binding

Source: src/GCP/AgentRegistry/Binding.ts

An Agent Registry binding connecting a source agent to a target agent, MCP server, or endpoint.

Create, update, and delete are long-running operations. bindingId, location, sourceIdentifier, and targetIdentifier replace the resource. Display name, description, and auth-provider settings update in place. Bindings have no labels API, so Alchemy stamps ownership into description so list / nuke can find them.

Binding: Creating a Binding

Generated name

const binding = yield* GCP.AgentRegistry.Binding("Orchestrator", {
  sourceIdentifier:
    "urn:agent:projects-123:projects:123:locations:us-central1:agentregistry:source",
  targetIdentifier:
    "urn:mcp:projects-123:projects:123:locations:us-central1:agentregistry:tools",
});

Named binding with a description

const binding = yield* GCP.AgentRegistry.Binding("Orchestrator", {
  bindingId: "orchestrator-tools",
  location: "us-central1",
  displayName: "orchestrator tools",
  description: "routes the orchestrator to the tools MCP server",
  sourceIdentifier: source.agentId,
  targetIdentifier: tools.mcpServerId,
});

Binding: Updating a Binding

Change props on the same logical id; the engine keeps the physical id.

const binding = yield* GCP.AgentRegistry.Binding("Orchestrator", {
  sourceIdentifier: source.agentId,
  targetIdentifier: tools.mcpServerId,
  displayName: "orchestrator tools v2",
  description: "updated routing",
});