atlas-graph-query

1# atlas-graph-query
2 
3A thin reference for the Atlas knowledge-graph MCP tool surface so any agent
4(including sub-agents) can query the graph without re-deriving conventions. The
5server URL is wired natively by the `atlas` plugin and is overridable via
6`ATLAS_MCP_URL`. Never invent node ids — only use ids returned by these tools.
7 
8> **Position: this is the SECONDARY / enrichment layer.** The `atlas` plugin is
9> scan-first — it inventories your REAL systems by scanning your actual sources
10> (Azure via read-only `az`, git repos, local directories) and process/data
11> mining them. The graph queries below are used ONLY to add best-practice /
12> comparison context to those already-discovered real systems. Do NOT use the
13> graph as the primary content, and never pad a real inventory with generic
14> catalog nodes. Tie every graph lookup back to a real scanned system.
15 
16## Tools
17 
18### `mcp__atlas__atlas_public_search`
19Full-text/semantic search over the graph. Key params: `q` (query), optional
20`kind` filter, `limit`. Prefer it to find seed/anchor nodes from need terms.
21 
22### `mcp__atlas__atlas_public_record`
23Fetch one node's full record by `id` (fields + edges). Use `expandNeighbors` to
24pull immediate relations in one call. Prefer it to read detail once you have ids.
25 
26### `mcp__atlas__atlas_public_neighbors`
27Traverse the graph from a node. Key params: `id`, `depth`, `edges` (edge-kind
28filter), `kinds` (node-kind filter). Prefer it to expand a subsystem from anchors.
29…