GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"gitdiagram": {
"url": "https://gitdiagram.com/mcp"
}
}
}Remote endpoints
https://gitdiagram.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (3)
🟢get_repository_diagram(repository)
Get the architecture of a public GitHub repository from GitDiagram (gitdiagram.com): a written explanation of how the codebase is organized, its main components with the source paths they live in, how those components connect, and a Mermaid flowchart of the whole system, plus a link to the interactive diagram, where every component opens its code on GitHub. Use it whenever the user wants to understand, visualize, map or explain a GitHub repository's or open-source project's architecture, structure, main modules or data flow, wants an overview before reading unfamiliar code, or asks for an architecture or system diagram of a repo. Read-only and fast: it returns the diagram GitDiagram has already made. If none exists yet, it returns a link that makes one when opened in a browser. Public repositories only. In chat apps that show interactive views, the result also appears as a zoomable diagram whose components open their code on GitHub.
Input Schema
{
"type": "object",
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "The GitHub repository as \"owner/repo\" (e.g. \"fastapi/fastapi\") or any github.com URL inside it (e.g. \"https://github.com/vercel/next.js/tree/canary/packages\")."
}
},
"required": [
"repository"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢find_repository_diagrams(query, limit)
Search GitDiagram's library of ready-made architecture diagrams of public GitHub repositories by owner or repository name. Matches any part of "owner/repo" (e.g. "langchain", "vercel/", "react-native") and returns up to 10 repositories, most-starred first, each with its interactive diagram link. Use it to find a project's exact owner/repo from its name, or to list which repositories of an owner or topic already have diagrams. It searches repository names only, not code or file contents.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Part of a repository's \"owner/repo\" name, e.g. \"fastapi\", \"microsoft/\", or \"next.js\"."
},
"limit": {
"description": "How many repositories to return (1–10, default 10).",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_explainer_video(repository)
Get GitDiagram's narrated explainer video of a public GitHub repository, if one has been made: the link to watch and share it, its title and length, and the full narration transcript, a plain-language walkthrough of what the project is for, what people do with it and how its main parts fit together. Use it when the user wants a video about a repository, something to watch or share instead of read, or a short spoken-style summary of a project. Read-only: it never makes a video; when none exists it says so and links the page where one can be made.
Input Schema
{
"type": "object",
"properties": {
"repository": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "The GitHub repository as \"owner/repo\" (e.g. \"fastapi/fastapi\") or any github.com URL inside it (e.g. \"https://github.com/vercel/next.js/tree/canary/packages\")."
}
},
"required": [
"repository"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence