AgentLens

Real-time AI agent catalog for Kubernetes — discover, track, and inspect A2A, MCP, and A2UI agents across your cluster.

AgentLens automatically discovers AI agents running in Kubernetes (via Service annotations), polls static endpoints, and accepts push registrations. It exposes a REST API and a web dashboard for browsing the catalog, filtering by protocol/status, and inspecting agent cards and capabilities.

---

Quickstart

Docker Compose

git clone https://github.com/PawelHaracz/agentlens
cd agentlens/examples
docker compose up

Open http://localhost:8080 in your browser.

Helm (Kubernetes)

helm install agentlens ./deploy/helm/agentlens \
  --namespace agentlens --create-namespace

AgentLens will start watching Services across all namespaces for agent annotations.

---

Main Sections

• Architecture — System design, components, and data flow
• API Reference — REST API endpoints and schemas
• User Guide — Using the web dashboard
• End User Guide — End-to-end usage walkthrough
• Developer Guide — Contributing and extending AgentLens
• DevOps Guide — Deployment, Helm, and Kubernetes
• Authentication — Auth configuration and JWT
• Database — Database setup and migrations
• Settings — Configuration reference