{
 "kind": "mcp",
 "slug": "com-gitdiagram-gitdiagram",
 "path": "mcp/servers/com-gitdiagram-gitdiagram/",
 "name": "GitDiagram",
 "maker": "ahmedkhaleel2004",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Git, GitHub and code review",
   "mcp/git/"
  ]
 ],
 "lead": "architecture diagrams of public code projects.",
 "chips": [
  {
   "label": "Git, GitHub and code review",
   "path": "mcp/git/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/ahmedkhaleel2004/gitdiagram"
  },
  {
   "label": "Website",
   "href": "https://gitdiagram.com"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "GitDiagram's remote MCP server: https://gitdiagram.com/mcp",
   "note": "The repo is GitDiagram's own source, from its maker; it serves gitdiagram.com, and the server only reads GitDiagram's own stored diagrams. It is not an official GitHub product.",
   "src": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/src/app/mcp/route.ts"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "No key needed",
   "status": "yes",
   "sub": "No account",
   "quote": "codex mcp add gitdiagram --url https://gitdiagram.com/mcp",
   "note": null,
   "src": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/README.md"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "Endpoint: https://gitdiagram.com/mcp. Checked: yes: an unauthenticated GET to https://gitdiagram.com/mcp answered 200.",
   "src": "https://gitdiagram.com/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "MIT license",
   "quote": "GitDiagram is a remote MCP server at https://gitdiagram.com/mcp (no key or sign-in).",
   "note": "Calling the free public server is allowed with no key; reuse terms for the generated diagrams are not stated, so credit GitDiagram and link the diagram.",
   "src": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/README.md"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What GitDiagram does",
   "parts": [
    {
     "t": "prose",
     "text": "GitDiagram turns a public GitHub project into a diagram of its main parts and how they connect, with a short written explanation. Its MCP server lets your AI assistant fetch that diagram in a chat, free and without sign-in, so you understand a project before reading its code."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Get the big picture of a new project",
       "text": "Before you dig into an unfamiliar open-source project, ask your assistant how it is put together and get its main parts and their links.",
       "idea": false
      },
      {
       "title": "A diagram for your docs or slides",
       "text": "Take the diagram's source text and paste it into a README or a doc that draws diagrams, or export a picture from the site.",
       "idea": false
      },
      {
       "title": "Find a project's exact name",
       "text": "You remember \"langchain\" but not who owns it. The assistant searches GitDiagram's library by name and gets the right one.",
       "idea": false
      },
      {
       "title": "Open the code behind each box",
       "text": "Every part in the diagram links to its folder or file on GitHub, so you go straight from the picture to the code.",
       "idea": false
      },
      {
       "title": "A one-minute video about a project",
       "text": "Get a short narrated video and its full transcript to share with people who would rather watch than read, when one already exists.",
       "idea": false
      },
      {
       "title": "Compare two libraries before choosing",
       "text": "Ask for the diagrams of two candidate libraries side by side to see which one is simpler before you pick it for your app.",
       "idea": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "GitDiagram popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "19K",
       "l": "GitHub stars, ahmedkhaleel2004/gitdiagram"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (3)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "get_repository_diagram",
       "text": "Returns a public project's stored diagram, explanation, main parts with source paths, their links and Mermaid source. Reads only."
      },
      {
       "name": "find_repository_diagrams",
       "text": "Searches GitDiagram's library of ready diagrams by owner or project name; up to 10 results. Reads only."
      },
      {
       "name": "get_explainer_video",
       "text": "Returns an existing narrated video of a project with its transcript; listed only when videos are switched on. Reads only."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "the project names and search words you ask about, your network address and the AI app's name",
       "sub": "To gitdiagram.com; on every tool call; calls are counted per tool and day for the operator, and the address is used for the usage cap. Opt out: read the Markdown page in a browser instead, or do not use the server."
      }
     ]
    },
    {
     "t": "prose",
     "text": "Calling the server is free and needs no account. GitDiagram's own code is under the MIT license; the pages we read do not state terms for reusing the diagrams it makes."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "With conditions",
       "status": "cond",
       "sub": "Calling the free public server is allowed with no key; reuse terms for the generated diagrams are not stated, so credit GitDiagram and link the diagram.",
       "quote": "GitDiagram is a remote MCP server at https://gitdiagram.com/mcp (no key or sign-in).",
       "src": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/README.md"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "GitDiagram's own code is MIT; copies must keep the copyright and permission notice.",
       "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
       "src": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/LICENSE"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "1.0.0 in the registry, updated Sep 29, 2026"
      },
      {
       "l": "Last release",
       "v": "Registry entry 1.0.0 published 2026-09-29; code read at commit d2637eb8f88f800d2827c65a089e1d82fd417ce0 (2026-11-10)"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: an unauthenticated GET to https://gitdiagram.com/mcp answered 200",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "GitDiagram",
       "me": true,
       "facts": [
        "19K stars",
        "Remote"
       ]
      },
      {
       "name": "GitHub",
       "why": "Pick it if the agent must read the real files, issues or pull requests, or the project is private",
       "path": "mcp/servers/io-github-github-github-mcp-server/",
       "facts": [
        "34.6K stars",
        "Remote"
       ]
      },
      {
       "name": "repomix",
       "why": "Pick it if you want the whole code of a project in one file for an AI to read",
       "path": null,
       "facts": [
        "Local"
       ]
      }
     ],
     "more": "All git, github and code review servers",
     "more_path": "mcp/git/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Use the gitdiagram MCP server to get the architecture diagram of fastapi/fastapi, then explain its main parts to me in plain words and give me the Mermaid source."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp"
      },
      {
       "tab": "Cursor",
       "code": "One-click Install in Cursor link in the README, or add a remote MCP server with the URL https://gitdiagram.com/mcp."
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"gitdiagram\": {\n      \"url\": \"https://gitdiagram.com/mcp\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Passing only a project name like \"next.js\" to get_repository_diagram",
       "fix": "Find the exact owner/repo with find_repository_diagrams first, then pass \"vercel/next.js\" or a github.com URL",
       "why": "The diagram tool takes \"owner/repo\" or a GitHub URL; the search tool exists to look the name up."
      },
      {
       "dont": "Asking it about a private repository",
       "fix": "Use the site's Private Repos option with your own GitHub token, or a server that reads your code directly",
       "why": "The server answers for public repositories only."
      },
      {
       "dont": "Using find_repository_diagrams to search code for a function name",
       "fix": "Search by owner or project name only",
       "why": "It matches parts of \"owner/repo\", not code or file contents."
      },
      {
       "dont": "Treating an old diagram as current",
       "fix": "Check the date shown with the diagram and open the link to regenerate it when the project changed a lot",
       "why": "The tool returns the stored diagram with the day it was generated, not a fresh one."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need an account or a key?",
       "a": "No. The server is public, read-only and needs no key or sign-in.",
       "evidence": {
        "url": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/README.md",
        "quote": "GitDiagram is a remote MCP server at https://gitdiagram.com/mcp (no key or sign-in)."
       }
      },
      {
       "q": "What if the project has no diagram yet?",
       "a": "The tool says so, suggests similar projects that have one, and gives a link that makes a diagram when you open it.",
       "evidence": {
        "url": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/src/server/mcp/server.ts",
        "quote": "If none exists yet, it returns a link that makes one when opened in a browser."
       }
      },
      {
       "q": "Can it make a new video?",
       "a": "No. get_explainer_video only returns a video that already exists; making new videos is in early access on the site.",
       "evidence": {
        "url": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/README.md",
        "quote": "Making new videos is in early access. Anyone can watch videos that already exist."
       }
      },
      {
       "q": "Can I use it without an AI app?",
       "a": "Yes. Add .md to a diagram address, like gitdiagram.com/owner/repo.md, to get the Markdown version.",
       "evidence": {
        "url": "https://github.com/ahmedkhaleel2004/gitdiagram/blob/d2637eb8f88f800d2827c65a089e1d82fd417ce0/README.md",
        "quote": "AI agents can use it too, through the MCP server or the Markdown version of any diagram (gitdiagram.com/owner/repo.md)."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "com.gitdiagram/gitdiagram"
  ],
  [
   "Category",
   "Git, GitHub and code review"
  ],
  [
   "Version",
   "1.0.0"
  ],
  [
   "Remote endpoint",
   "https://gitdiagram.com/mcp"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "GitHub",
   "ahmedkhaleel2004/gitdiagram"
  ],
  [
   "In the registry since",
   "Sep 29, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "Public projects only. Private code can be diagrammed on the website with your own GitHub token, not through the server.",
  "It returns only diagrams GitDiagram has already made. For a new project you get a link that makes one when opened in a browser.",
  "All tools only read; nothing is written, deleted or paid for."
 ],
 "checked_line": "Read by AgentGid from 11 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/ahmedkhaleel2004.png"
}