Graph Atlas Mcp
by darrenjrobinsoncommunityv0.1.0
Tracks schema changes in the Microsoft Graph API across v1.0 and beta by daily diffing $metadata, including documented and undocumented changes. It also correlates changes with permissions and Entra roles, and provides an interactive schema visualizer inside the MCP client.
From the registry: Tracks documented and undocumented Microsoft Graph API schema changes, with an MCP Apps visualiser
Install & configure
Prerequisites
- requiredInstall Node.js 22+Node.js 22 or later is required because the server uses the built-in node:sqlite module.https://nodejs.org/?
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `graph-atlas-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 22+** — Node.js 22 or later is required because the server uses the built-in node:sqlite module. (https://nodejs.org/?)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","graph-atlas-mcp"]
- optional environment variables:
- `OPENAI_API_KEY`: Optional OpenAI API key to enable hybrid semantic + keyword search for search_changes. Without it, the server still works in keyword-only mode. (example: `<your-openai-api-key>`)
- `GRAPH_ATLAS_DB`: Optional path to an explicit local graph-atlas.db file. If unset, the server auto-downloads and uses the latest released database in ~/.graph-atlas-mcp/, then falls back to ./graph-atlas.db. (example: `<absolute-path-to-graph-atlas.db>`)
Note: On first launch, the server automatically downloads the latest published database from GitHub Releases into ~/.graph-atlas-mcp/ and keeps it up to date. No Microsoft Graph or Entra app registration is required for normal use.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: On first launch, the server automatically downloads the latest published database from GitHub Releases into ~/.graph-atlas-mcp/ and keeps it up to date. No Microsoft Graph or Entra app registration is required for normal use.
Tools (11)
search_changes
Natural-language or keyword search across all tracked change sources, with hybrid semantic search when an OpenAI key is configured.
get_recent_changes
Query recent changes with filters such as date, endpoint, object type/name, change kind, and source.
get_object_history
Return the full change history for a specific object across sources.
get_change_detail
Return full details for one change record plus related changes from the same day and object.
get_snapshot_summary
Show entity, property, and enum counts for a snapshot.
get_permission_context
Show which permissions touch a Graph object, what they unlock, who can grant them, and recent changes.
schema_change_report
Return structured JSON of the schema, permission, and role graph with nodes, edges, and change-activity counts.
visualize_schema_graph
Open the interactive schema visualizer inside the MCP client.
expand_schema_node
Expand one node in the open visualizer or return its one-node neighborhood delta.
search_schema_objects
Search and resolve fuzzy names across entity types, permissions, and roles.
get_node_timeline
Return a compact change timeline for a node in the visualizer detail panel.
Environment variables
OPENAI_API_KEYrequiredEnables hybrid keyword plus semantic search for search_changes and is used to generate embeddings.GRAPH_ATLAS_DBrequiredPoints the server at an explicit local database file instead of the default download/cache location.Prerequisites
- • Node.js 22+
Packages
graph-atlas-mcp
npmv0.1.0transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Aug 7, 2026
- Last commit
- Aug 9, 2026
- Registry name
- io.github.darrenjrobinson/graph-atlas-mcp