# github/agentfinder-catalog architecture

> Architecture diagram of the GitHub repository github/agentfinder-catalog, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/github/agentfinder-catalog
- Repository: https://github.com/github/agentfinder-catalog

## Overview

Agent Finder Catalog is a community-maintained registry of agent capabilities. Contributors add per-resource JSON entries under catalog/<publisher>/; the generator combines those entries with GitHub MCP catalog and registry data to produce ai-catalog.json, which Agent Finder uses for runtime discovery. The graph reflects README statements and the generator excerpt; other catalog processing details are not assumed.

Main entry points: [`scripts/generate_ai_catalog.py`](https://github.com/github/agentfinder-catalog/blob/main/scripts/generate_ai_catalog.py) (ARD generator), [`catalog`](https://github.com/github/agentfinder-catalog/tree/main/catalog) (Publisher entries), [`ai-catalog.json`](https://github.com/github/agentfinder-catalog/blob/main/ai-catalog.json) (Ingestion catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog sources"]
  node_entries["Publisher entries"]
  node_mcp_catalog["GitHub MCP catalog"]
  node_mcp_registry["GitHub MCP registry"]
end

subgraph group_ingestion["Catalog generation"]
  node_generator["ARD generator"]
  node_output["Ingestion catalog<br/>[ai-catalog.json]"]
end

subgraph group_discovery["Agent discovery"]
  node_finder["Copilot Agent Finder"]
end

node_contributors(("Contributors"))

node_contributors -->|"maintain entries"| node_entries
node_generator -->|"reads entries"| node_entries
node_generator -->|"loads catalog"| node_mcp_catalog
node_generator -->|"loads records"| node_mcp_registry
node_generator -->|"generates"| node_output
node_finder -->|"searches catalog"| node_output

click node_entries "https://github.com/github/agentfinder-catalog/tree/main/catalog"
click node_generator "https://github.com/github/agentfinder-catalog/blob/main/scripts/generate_ai_catalog.py"
click node_output "https://github.com/github/agentfinder-catalog/blob/main/ai-catalog.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entries,node_mcp_catalog,node_mcp_registry toneBlue
class node_generator,node_output toneAmber
class node_finder toneMint
class node_contributors toneIndigo
```

## Components

### Catalog sources

- [Publisher entries](https://github.com/github/agentfinder-catalog/tree/main/catalog): `catalog`
- **GitHub MCP catalog**
- **GitHub MCP registry**

### Catalog generation

- [ARD generator](https://github.com/github/agentfinder-catalog/blob/main/scripts/generate_ai_catalog.py): `scripts/generate_ai_catalog.py`
- [Ingestion catalog](https://github.com/github/agentfinder-catalog/blob/main/ai-catalog.json): `ai-catalog.json`

### Agent discovery

- **Copilot Agent Finder**

### Other components

- **Contributors**

## Connections

- Contributors → Publisher entries: maintain entries (evidence: `README.md`)
- ARD generator → Publisher entries: reads entries (evidence: `scripts/generate_ai_catalog.py`)
- ARD generator → GitHub MCP catalog: loads catalog (evidence: `scripts/generate_ai_catalog.py`)
- ARD generator → GitHub MCP registry: loads records (evidence: `scripts/generate_ai_catalog.py`)
- ARD generator → Ingestion catalog: generates (evidence: `README.md`)
- Copilot Agent Finder → Ingestion catalog: searches catalog (evidence: `README.md`)
