---
name: a5c-ai/atlas-graph-query
source: https://app.decimal.ai/s/a5c-ai-atlas-graph-query@1/SKILL.md
source_sha256: f9fb9c33868d
---

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