How agentregistry-dev/agentregistry works
AgentRegistry is a catalog and delivery platform for MCP servers, agents, skills, and prompts. A developer authors or selects an artifact, registers it through arctl or the web UI, and consumes it by running locally or deploying to a shared environment; IDE configuration is another documented consumption path. The graph includes the CLI, web/API surfaces, persistence, and reconciliation as distinct layers. Several runtime connections are documented in the README; sampled source confirms selected API, store, and controller responsibilities, but not every route or UI request.
Main entry points: store.go Versioned resource store · commands CLI workflows · server.go HTTP server · router.go API routes
Components 23
Build and author
- Artifact definitions
pkg/api/v1alpha1
User interfaces
- arctl CLI
pkg/cli/root.go - CLI workflows
internal/cli/commands - IDE configuration
internal/cli/configure/configure.go - Admin web UI
ui/app/page.tsx - UI API client
ui/lib/api/client/client.gen.ts
Registry services
- HTTP server
internal/registry/api/server.go - API routes
internal/registry/api/router/router.go - Resource handlers
pkg/registry/resource/handler.go - MCP compatibility API
internal/registry/api/handlers/mcpregistry/handlers.go - MCP catalog bridge
internal/mcp/registryserver/server.go - Access control
pkg/registry/auth/auth.go - Versioned resource store
pkg/registry/v1alpha1store/store.go - Database
pkg/registry/database/database.go
Delivery and runtime
- Deployment reconciliation
internal/registry/controller/controller.go - Plugin reconciliation
internal/registry/controller/plugin_controller.go - Skill reconciliation
internal/registry/controller/skill_controller.go - Local execution
pkg/cli/runtime/runtime.go
Other components
- Developer
- Kubernetes environment
- AI client
- agentgateway
- Artifact sources
Connections 25
- Developer → arctl CLI: uses
- Developer → Admin web UI: uses
- Developer → Artifact definitions: defines
- arctl CLI → CLI workflows: dispatches
pkg/cli/root.go - CLI workflows → Artifact definitions: registers
- CLI workflows → Local execution: runs locally
- CLI workflows → IDE configuration: configures clients
- Admin web UI → UI API client: requests data
- UI API client → HTTP server: sends HTTP
- HTTP server → API routes: registers routes
internal/registry/api/server.go - API routes → Resource handlers: registers handlers
internal/registry/api/router/router.go - API routes → MCP compatibility API: registers routes
internal/registry/api/router/router.go - Resource handlers → Versioned resource store: reads and writes
pkg/registry/resource/handler.go - MCP compatibility API → Versioned resource store: reads resources
internal/registry/api/handlers/mcpregistry/handlers.go - MCP catalog bridge → Versioned resource store: reads resources
internal/mcp/registryserver/server.go - HTTP server → Access control: configures access
internal/registry/api/server.go - Versioned resource store → Database: persists records
- Deployment reconciliation → Versioned resource store: reconciles deployments
internal/registry/controller/controller.go - Skill reconciliation → Versioned resource store: resolves skill records
internal/registry/controller/skill_controller.go - Plugin reconciliation → Versioned resource store: reconciles plugins
internal/registry/controller/plugin_controller.go - Artifact sources → Artifact definitions: supplies packages
- Kubernetes environment → Deployment reconciliation: hosts deployments
- Local execution → AI client: serves locally
- agentgateway → AI client: provides access
- MCP catalog bridge → AI client: serves MCP tools