---
name: atlas-graph-query
description: >
  Reference for querying the Atlas knowledge graph through its MCP tools — the
  SECONDARY enrichment/comparison layer that adds best-practice context to systems
  you have ALREADY scanned from your real sources (`az`, repos, dirs). Use when
  you need to look up nodes, edges, kinds, clusters, stats, or wiki pages in Atlas
  to compare against your real inventory. (atlas graph, query atlas, atlas mcp,
  search the graph, graph neighbors, atlas record, atlas kinds, enrichment layer)
allowed-tools: mcp__atlas__atlas_public_search, mcp__atlas__atlas_public_record, mcp__atlas__atlas_public_neighbors, mcp__atlas__atlas_public_kinds, mcp__atlas__atlas_public_kind, mcp__atlas__atlas_public_edge_kinds, mcp__atlas__atlas_public_edge_kind, mcp__atlas__atlas_public_clusters, mcp__atlas__atlas_public_stats, mcp__atlas__atlas_public_wiki_page
version: 0.1.0
---

# atlas-graph-query

A thin reference for the Atlas knowledge-graph MCP tool surface so any agent
(including sub-agents) can query the graph without re-deriving conventions. The
server URL is wired natively by the `atlas` plugin and is overridable via
`ATLAS_MCP_URL`. Never invent node ids — only use ids returned by these tools.

> **Position: this is the SECONDARY / enrichment layer.** The `atlas` plugin is
> scan-first — it inventories your REAL systems by scanning your actual sources
> (Azure via read-only `az`, git repos, local directories) and process/data
> mining them. The graph queries below are used ONLY to add best-practice /
> comparison context to those already-discovered real systems. Do NOT use the
> graph as the primary content, and never pad a real inventory with generic
> catalog nodes. Tie every graph lookup back to a real scanned system.

## Tools

### `mcp__atlas__atlas_public_search`
Full-text/semantic search over the graph. Key params: `q` (query), optional
`kind` filter, `limit`. Prefer it to find seed/anchor nodes from need terms.

### `mcp__atlas__atlas_public_record`
Fetch one node's full record by `id` (fields + edges). Use `expandNeighbors` to
pull immediate relations in one call. Prefer it to read detail once you have ids.

### `mcp__atlas__atlas_public_neighbors`
Traverse the graph from a node. Key params: `id`, `depth`, `edges` (edge-kind
filter), `kinds` (node-kind filter). Prefer it to expand a subsystem from anchors.

### `mcp__atlas__atlas_public_kinds`
List all node kinds in the graph. Use to scope a domain to relevant kinds.

### `mcp__atlas__atlas_public_kind`
Describe a single node kind (schema/fields). Use before relying on a kind's shape.

### `mcp__atlas__atlas_public_edge_kinds`
List all edge kinds. Use to understand how nodes relate.

### `mcp__atlas__atlas_public_edge_kind`
Describe a single edge kind. Use to interpret a specific relation type.

### `mcp__atlas__atlas_public_clusters`
List graph clusters (thematic groupings). Use to scope a domain to cluster(s).

### `mcp__atlas__atlas_public_stats`
Graph-level counts/metrics. Use for sizing and sanity checks.

### `mcp__atlas__atlas_public_wiki_page`
Fetch a narrative wiki page for context. Use to capture human-readable nuance.

## Query recipes

- **Find by need** — `atlas_public_search(q=<need terms>)` → take top ids.
- **Expand a subsystem** — `atlas_public_neighbors(id, depth=2, kinds=[...])`.
- **Inspect a node** — `atlas_public_record(id, expandNeighbors=true)`.
- **Browse a cluster** — `atlas_public_clusters` → pick cluster → `search`/
  `neighbors` scoped to it.