Skip to directory

About Agent Registry MCP

Google Cloud managed MCP server for Agent Registry. Exact tool names and accessible operations depend on the published server reference and configured Google Cloud permissions.

What you can use it for

  • Return a paginated list of agents within a specified Google Cloud project and location. Use this to enumerate all agents or filter by basic resource attributes. Don't use this for natural language discovery; use search_agents instead.
  • Perform a keyword or prefix search to discover agents within a specific project and location. Use this when you need to find an agent based on natural language queries, specific skills, tags, or descriptions.
  • Retrieve the full metadata and configuration details of a specific agent using its unique resource name. Use this when you already know the agent's ID and need to inspect its capabilities, protocols, or endpoints.
  • Return a paginated list of registered endpoints accessed by agents in a given project and location.
  • Retrieve details of a single registered endpoint using its unique resource name, including its connection interfaces and protocol bindings.
  • Return a paginated list of MCP servers within a specified Google Cloud project and location. Use this to enumerate servers. For keyword discovery, use search_mcp_servers instead.
Connection and setup
Hosting
Google-managed remote
Transport
Streamable HTTP
Endpoint
https://agentregistry.googleapis.com/mcp
Authentication
Google Cloud authentication: OAuth 2.0 using Application Default Credentials (ADC) in supported Google clients, or a client OAuth ID/secret or bearer token in compatible third-party clients. The principal needs mcp.tools.call plus the underlying product permissions; API key authentication is only available for services that explicitly support it.

Requirements

  • A Google Cloud project and access to the target product/resource.
  • Enable this MCP service and its underlying Google Cloud API as required by the product guide.
  • An MCP client that supports Streamable HTTP.
  • An identity with the MCP Tool User role (roles/mcp.toolUser) or equivalent mcp.tools.call permission, plus permissions for the underlying product operations.

Setup steps

  1. Choose the correct global or regional endpoint for your data location; this catalog lists the documented endpoint.
  2. In the Google Cloud project, enable the MCP service and the underlying product API if the product guide requires it.
  3. Authenticate the client with Google Cloud ADC (simplest with Antigravity/Gemini CLI) or configure OAuth 2.0 credentials in a compatible client.
  4. Grant the connecting identity roles/mcp.toolUser and only the product IAM roles needed for the intended operations.
  5. Add agentregistry.googleapis.com to the client as a Streamable HTTP MCP server and complete sign-in.
  6. Refresh the client tool list and check that the tools match the product reference; availability may depend on permissions and selected toolset.
Tools 20

Official Google Cloud docs enumerate 20 tools for discovery and management. Reads search/list registry metadata; create/update/delete service and binding operations change registry configuration. Access requires Google Cloud IAM permissions, including mcp.tools.call and product-specific permissions.

  • list_agents

    Return a paginated list of agents within a specified Google Cloud project and location. Use this to enumerate all agents or filter by basic resource attributes. Don't use this for natural language discovery; use search_agents instead.

    01
  • search_agents

    Perform a keyword or prefix search to discover agents within a specific project and location. Use this when you need to find an agent based on natural language queries, specific skills, tags, or descriptions.

    02
  • get_agent

    Retrieve the full metadata and configuration details of a specific agent using its unique resource name. Use this when you already know the agent's ID and need to inspect its capabilities, protocols, or endpoints.

    03
  • list_endpoints

    Return a paginated list of registered endpoints accessed by agents in a given project and location.

    04
  • get_endpoint

    Retrieve details of a single registered endpoint using its unique resource name, including its connection interfaces and protocol bindings.

    05
  • list_mcp_servers

    Return a paginated list of MCP servers within a specified Google Cloud project and location. Use this to enumerate servers. For keyword discovery, use search_mcp_servers instead.

    06
  • search_mcp_servers

    Perform a keyword or prefix search to discover MCP servers. Use this to find servers based on the specific tools they offer, their descriptions, or natural language queries.

    07
  • get_mcp_server

    Retrieve the full metadata of a specific MCP server using its unique resource name. Use this to inspect the exact tools and schemas exposed by a known server.

    08
  • list_services

    List services in a given project and location. A service can represent a manually onboarded MCP server, agent or REST endpoint.

    09
  • get_service

    Retrieve a specific service record. A service can represent a manually onboarded MCP server, agent or REST endpoint. This shows the underlying registration specification used to manually onboard a resource.

    10
  • create_service

    Manually register a new custom workload by creating a Service resource. A service can represent a manually onboarded MCP server, agent or REST endpoint. Use this to onboard third-party agents, remote MCP servers, or REST endpoints by providing their specification.

    11
  • update_service

    Update the specification or parameters of an existing service. A service can represent a manually onboarded MCP server, agent or REST endpoint. Use this to patch an uploaded Agent Card, MCP tool specification, or endpoint bindings.

    12
  • delete_service

    Delete a service record, effectively deregistering the manually onboarded agent, MCP server, or REST endpoint from the registry.

    13
  • list_bindings

    Return a paginated list of bindings within a specified Google Cloud project and location.

    14
  • get_binding

    Retrieve details of a single binding using its unique resource name.

    15
  • create_binding

    Create a new binding between an agent and another resource (agent, MCP server, or endpoint).

    16
  • update_binding

    Update the specification or parameters of an existing binding.

    17
  • delete_binding

    Delete a binding record, effectively removing the connection between resources.

    18
  • fetch_available_bindings

    Fetch available bindings for a given source resource.

    19
  • get_operation

    Gets the latest state of a long-running operation.

    20
Original sources
  • official tool reference

    Product-specific Google MCP reference publishes 20 exact tool identifiers and descriptions in its tools reference.

  • official server catalog

    Official Google Cloud catalog lists this product as an available remote MCP server.

  • official setup guide

    Google Cloud describes remote MCP client setup, Streamable HTTP transport, supported authentication options, and ADC setup.

  • official authentication guide

    Google documents supported identity types and authorization requirements for Google Cloud MCP calls.

  • official setup and tool reference

    Current Google Cloud docs describe available discovery/administrative tools, IAM permissions, and a public tools/list request.

  • official tool schema

    Official reference provides exact schema for list_agents and links to the documented registry tool catalog.

Documentation checked 2026-10-28. Connection has not been runtime tested.