Reference Implementations¶
Hugging Face Discover Tool¶
The Hugging Face Discover Tool provides search access to thousands of Skills, ML Applications, and MCP Servers — on Hugging Face - or any other ARD compliant service.
Hugging Face CLI (hf)¶
discover is built into the Hugging Face CLI (hf). To get started:
# Install the Hugging Face CLI tool:
uv tool install huggingface_hub
# Search for resources to train a model
hf discover search "Fine tune a language model"
# Find MCP Servers to generate an image
hf discover search "Generate an image" --json --kind mcp
# Search other registries
hf discover search "Purchase aeroplane tickets" --registry-url <catalog-url>
# Navigate a federated catalog from a website
hf discover navigate <web-url> "Research biomedical datasets"
REST and MCP API Access¶
Query the Hugging Face catalog service directly via:
- The REST API at:
https://huggingface-hf-discover.hf.space/search - MCP at:
https://huggingface-hf-discover.hf.space/mcp
GitHub Agent Finder¶
GitHub's Agent Finder is a discovery service for agentic resources — Skills, tools, and MCP servers — reachable over HTTPS at https://agentfinder.github.com/api/v1.
GitHub Copilot¶
GitHub Copilot can search it directly: add Agent Finder as a remote MCP tool (or as custom instructions), then ask Copilot to find a capability for your task and it returns ranked matches you choose to install. See Connect GitHub Copilot for the full setup — it uses this same endpoint as its example.
HTTP API¶
Call search directly at POST https://agentfinder.github.com/api/v1/search. The MCP endpoint is https://agentfinder.github.com/api/v1/mcp.
Cisco AI Catalog¶
The AGNTCY Agent Directory reference implementation of ARD is deployed by the Cisco AI Catalog.
The catalog can be pulled from ai-catalog.outshift.io/.well-known/ai-catalog.json.
It supports secure verification through trust manifests, so clients can validate publisher identity and resource integrity before use.
1. Pull the catalog manifest¶
curl -sS https://ai-catalog.outshift.io/.well-known/ai-catalog.json | jq '.specVersion, .host.displayName'
2. Discover A2A cards¶
curl -sS 'https://ai-catalog.outshift.io/v1/agents?filter=type%3Dapplication%2Fa2a-agent-card%2Bjson' \
| jq -r '.results[] | "\(.displayName)\t\(.data.card_data.url // .identifier)"'