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