Google

Agent Registry API

Agent Registry is a centralized, unified catalog that lets you store, discover, and govern Model Context Protocol (MCP) servers, tools, and AI agents within…

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Agent Registry is a centralized, unified catalog that lets you store, discover, and govern Model Context Protocol (MCP) servers, tools, and AI agents within Google Cloud.

Endpoints 27

projects.locations.skills.revisions

  • GETGets details of a single immutable Revision./v1/:nameGets details of a single immutable Revision.
  • DELETEDeletes a specific revision (restricted to admins to purge accidentally committed secrets)./v1/:name?requestId=stringDeletes a specific revision (restricted to admins to purge accidentally committed secrets).
  • GETLists all revisions belonging to a parent Skill./v1/:parent/revisions?pageSize=0&pageToken=stringLists all revisions belonging to a parent Skill.
  • POSTCreates a new immutable revision and triggers validation pipelines./v1/:parent/revisions?requestId=string&skillRevisionId=stringCreates a new immutable revision and triggers validation pipelines.

projects.locations.skills

  • PATCHUpdates Skill metadata or overrides active pointers/state using REST standard PATCH./v1/:name?requestId=string&updateMask=stringUpdates Skill metadata or overrides active pointers/state using REST standard PATCH.
  • GETGets the access control policy for a resource/v1/:resource:getIamPolicy?options.requestedPolicyVersion=0Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
  • POSTSets the access control policy on the specified resource/v1/:resource:setIamPolicySets the access control policy on the specified resource. Replaces any existing policy. Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.
  • POSTReturns permissions that a caller has on the specified resource/v1/:resource:testIamPermissionsReturns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND…
  • GETLists logical Skills available in a project./v1/:parent/skills?filter=string&orderBy=string&pageSize=0&pageToken=stringLists logical Skills available in a project.
  • POST========================================================================= # Skills Collection APIs Creates a Skill…/v1/:parent/skills?requestId=string&skillId=string========================================================================= # Skills Collection APIs Creates a Skill resource container, optionally publishing…
  • GETCustom deep-search method to filter by frontmatter or query SKILL.md text blobs./v1/:parent/skills:search?filter=string&pageSize=0&pageToken=string&searchString=string&searchType=SEARCH_TYPE_UNSPECIFIEDCustom deep-search method to filter by frontmatter or query SKILL.md text blobs.

projects.locations

  • GETLists information about the supported locations for this service/v1/:name/locations?extraLocationTypes=string&filter=string&pageSize=0&pageToken=stringLists information about the supported locations for this service. This method lists locations based on the resource scope provided in the…

projects.locations.aiApplications.agents

  • GETLists Agents under an AI Application./v1/:parent/agents?pageSize=0&pageToken=stringLists Agents under an AI Application.

projects.locations.agents

  • POSTSearches Agents in a given project and location./v1/:parent/agents:searchSearches Agents in a given project and location.

projects.locations.aiApplications

  • GETLists AI Applications in a given project and location./v1/:parent/aiApplications?filter=string&orderBy=string&pageSize=0&pageToken=stringLists AI Applications in a given project and location.

projects.locations.endpoints

  • GETLists Endpoints in a given project and location./v1/:parent/endpoints?filter=string&pageSize=0&pageToken=stringLists Endpoints in a given project and location.

projects.locations.mcpServers

  • GETLists McpServers in a given project and location./v1/:parent/mcpServers?filter=string&orderBy=string&pageSize=0&pageToken=stringLists McpServers in a given project and location.
  • POSTSearches McpServers in a given project and location./v1/:parent/mcpServers:searchSearches McpServers in a given project and location.

projects.locations.bindings

  • GETLists Bindings in a given project and location./v1/:parent/bindings?filter=string&orderBy=string&pageSize=0&pageToken=stringLists Bindings in a given project and location.
  • POSTCreates a new Binding in a given project and location./v1/:parent/bindings?bindingId=string&requestId=stringCreates a new Binding in a given project and location.
  • GETFetches available Bindings./v1/:parent/bindings:fetchAvailable?pageSize=0&pageToken=string&sourceIdentifier=string&targetIdentifier=stringFetches available Bindings.

projects.locations.findings

  • GETLists Findings in a given project and location./v1/:parent/findings?filter=string&orderBy=string&pageSize=0&pageToken=stringLists Findings in a given project and location.

projects.locations.operations

  • POSTStarts asynchronous cancellation on a long-running operation/v1/:name:cancelStarts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the…
  • GETLists operations that match the specified filter in the request/v1/:name/operations?filter=string&pageSize=0&pageToken=string&returnPartialSuccess=trueLists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

projects.locations.publishers

  • GETLists all Publishers in a location./v1/:parent/publishers?pageSize=0&pageToken=stringLists all Publishers in a location.

projects.locations.services

  • GETLists Services in a given project and location./v1/:parent/services?filter=string&pageSize=0&pageToken=stringLists Services in a given project and location.
  • POSTCreates a new Service in a given project and location./v1/:parent/services?requestId=string&serviceId=stringCreates a new Service in a given project and location.

API details

Base URL
https://agentregistry.googleapis.com
Authentication
OAuth 2.0 (authorization code flow) with 4 scopes
An API key in the key query parameter
Operations
27 operations on 21 pathsGET 16POST 9PATCH 1DELETE 1
Main resources
projects.locations.skills 7projects.locations.skills.revisions 4projects.locations.bindings 3projects.locations.mcpServers 2projects.locations.operations 2projects.locations.services 2projects.locations 1projects.locations.agents 1projects.locations.aiApplications 1projects.locations.aiApplications.agents 1
Response formats
application/json
Description format
Google API Discovery, API version v1

How to test the Agent Registry API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Agent Registry API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 4 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Gets details of a single immutable Revision.” (GET /v1/:name), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Agent Registry API?

Agent Registry is a centralized, unified catalog that lets you store, discover, and govern Model Context Protocol (MCP) servers, tools, and AI agents within… It is listed under Developer tools and has 27 endpoints.

Who publishes the Agent Registry API?

It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Agent Registry API?

Requests go to https://agentregistry.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Agent Registry API?

It accepts 2 methods: OAuth 2.0 (authorization code flow) with 4 scopes; an API key in the key query parameter.

How many endpoints does the Agent Registry API have?

27 operations on 21 paths (16 GET, 9 POST, 1 PATCH, 1 DELETE). The largest groups are projects.locations.skills, projects.locations.skills.revisions, projects.locations.bindings, projects.locations.mcpServers.

Is forking the Agent Registry API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.