# Agentic AI Atlas for Agents

Agentic AI Atlas is a public, read-only graph of agent stacks, tools, tool servers, roles, workflows, capabilities, wiki pages, and implementation metadata.

## Canonical URLs

- Human guide: https://localhost:3000/for-agents
- MCP endpoint: https://localhost:3000/api/mcp
- MCP manifest: https://localhost:3000/mcp.json
- Well-known MCP manifest: https://localhost:3000/.well-known/mcp.json
- OpenAPI JSON: https://localhost:3000/api/v1/openapi.json
- OpenAPI docs: https://localhost:3000/api/v1/docs

## Current Graph Snapshot

- Records: 17,304
- Edges: 87,084
- Node kinds: 245
- Edge kinds: 408
- Clusters: 20
- YAML files: 2,693
- Parse errors: 1

## High-Volume Node Kinds

- LibraryProcess: 2,233 records
- LibrarySkill: 2,084 records
- LibraryAgent: 1,329 records
- Claim: 1,061 records
- SkillArea: 803 records
- Workflow: 801 records
- Page: 765 records
- EvidenceSource: 443 records

## MCP Tools

- `atlas_public_stats`: Return public Atlas graph counts and index statistics.
- `atlas_public_clusters`: List public Atlas clusters and their record counts.
- `atlas_public_search`: Search the public Atlas catalog by id, title, display name, description, or node kind.
- `atlas_public_record`: Fetch a public Atlas record with attributes and inbound/outbound edges.
- `atlas_public_neighbors`: Fetch a bounded public Atlas neighborhood around a record id.
- `atlas_public_kinds`: List public Atlas node kinds, optionally scoped to a cluster.
- `atlas_public_kind`: Fetch one node kind plus a paginated slice of its public instances.
- `atlas_public_edge_kinds`: List public Atlas edge kinds and their wired pair counts.
- `atlas_public_edge_kind`: Fetch one edge kind plus a paginated slice of its public wired pairs.
- `atlas_public_wiki_page`: Fetch a public Atlas wiki page by slug, including article markdown and documented record links.
- `atlas_public_openapi`: Return the public REST OpenAPI document and the docs/spec URLs.

## Recommended Agent Workflow

1. Start with `atlas_public_search` for a role, workflow, tool, tool server, capability, or wiki term.
2. Use `atlas_public_record` with `expandNeighbors: true` for exact graph context.
3. Use `atlas_public_neighbors` for bounded projections around a record.
4. Use `atlas_public_wiki_page` when a wiki slug is the best human-readable explanation.
5. Use `atlas_public_openapi` when REST endpoints are easier than MCP tools.

## Usage Notes

- Treat the public graph as read-only.
- Prefer exact record ids from search results before traversing neighbors.
- Keep neighbor depth small unless the user asks for broad exploration.
- When summarizing graph facts, include the record id and edge kind that support each claim.