There are a couple of ways to make MCP server information discoverable by clients - either by the MCP Registry protocol, or the recently announced ARD Agentic Resource Discovery Specification, which includes not only MCP, but also any type of agentic resource, from sub-agents, skills, APIs, workflows, etc..
In this tutorial, we will focus on the MCP Registry protocol, and deploying an Apigee proxy that makes Apigee API Hub MCP data available in the MCP Registry format, making it easily consumable by coding agents or any frontend or registry app.
The source code is available in this repository: GitHub - gcp-samples/apigee-mcp-registry: A sample proxy to offer Apigee API Hub MCP servers in the MCP Registry Discovery format. · GitHub.
Step 1: Clone the Repository
You can do this either in Google Cloud Shell or on your local machine.
git clone https://github.com/gcp-samples/apigee-mcp-registry.git
cd apigee-mcp-registry
Step 2: Deploy to Apigee X
To deploy the YAML proxy, use the Apigee Feature Templater (aft) tool.
# Install aft, if needed
npm i apigee-templater -g
# Set env variables
GOOGLE_CLOUD_PROJECT=YOUR_PROJECT
APIGEE_ENVIRONMENT=YOUR_ENVIRONMENT
SERVICE_ACCOUNT=YOUR_SA
# deploy proxy
aft -i mcp-registry.yaml -o $GOOGLE_CLOUD_ENVIRONMENT:mcp-registry:$APIGEE_ENVIRONMENT:$SERVICE_ACCOUNT
Step 3: Test MCP Registry Discovery Data
After deploying, you can test the MCP Registry discovery format with any compatible tool. For example, the tool mcp-registry can load any registry endpoint and show the MCP services.
You can also just do a curl call on the /mcp-registry/servers.json endpoint of your deployed proxy.
curl https://8.232.129.124.nip.io/mcp-registry/servers.json
Conclusion
Offering conversion proxies is a simple and effective way of supporting different standards and protocols. In a future post we will also dive into offering ARD-compatible proxies for future tooling that will support that format.
Do you have questions or suggestions on this or a related topic? Just post in the comments!
Ask a Google Cloud Sales Specialist about your project