atlas-graph-query

# 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.