GitDiagram logo

GitDiagram

Analyze GitHub repository architecture, Mermaid diagrams, stored diagrams, and explainer videos through a remote MCP endpoint.

Install GitDiagram

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
Server URL
https://gitdiagram.com/mcp

Remote servers are added in the app, not the config file: Customize → Connectors → Add custom connector, then paste this URL.

Overview

GitDiagram MCP server connects AI agents to public GitHub repository architecture data through a remote endpoint at https://gitdiagram.com/mcp. It provides architecture explanations, components, connections, Mermaid source, stored-diagram search, and explainer video access without requiring a key or sign-in. Reach for it when an agent needs a high-level view of how a repository is organized or wants to locate an existing diagram.

Use cases

  • Explain the architecture of a public GitHub repository
  • Retrieve Mermaid source for an existing repository diagram
  • Search stored diagrams for a codebase
  • Inspect components and connections before contributing
  • Get an available narrated repository explainer video

Key features

  • Public GitHub repository architecture explanations
  • Component and connection retrieval
  • Mermaid source access
  • Stored diagram search
  • Explainer video retrieval
  • Remote MCP access without a key or sign-in

Tools3

What GitDiagram lets your agent do. Expand a tool for its parameters.

Verified live~791 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

33/33 checks healthy over the last 23d

What it can do

From the 3 tools this server returned when we ran it.

Read-only tools · 3

Observed 2026-10-15 in an isolated sandbox. A description of reach, not a security audit.

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars18kStargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How GitDiagram works

What GitDiagram MCP server does

GitDiagram MCP server gives AI agents access to architecture information derived from GitHub repositories. An agent can inspect a repository’s explanation, see its identified components and connections, retrieve the Mermaid representation, search diagrams stored by GitDiagram, and obtain available explainer videos.

The service is intended for codebase orientation rather than direct code editing. It helps an agent answer questions about how a repository is structured, which parts are connected, and where the relevant files or directories appear in the generated architecture. The underlying GitDiagram product also provides interactive diagrams, links from diagram components to code locations, PNG export, and Mermaid copying, although the README specifically describes the MCP interface in terms of repository analysis and retrieval.

How it works

The hosted endpoint is available at https://gitdiagram.com/mcp. Clients connect to it as a remote MCP server using HTTP.

A typical agent request names a public repository, such as fastapi/fastapi, and asks how it is structured. GitDiagram then exposes the stored or generated architecture information through MCP tools. The result can include a textual explanation, component and connection data, Mermaid source, search results for stored diagrams, or an explainer video when one is available.

The repository also offers a web interface at GitDiagram.com. Public repositories can be visualized there, while private repositories can be used through the site with a GitHub token.

Setup and configuration

For hosted use, add the remote server URL to an MCP-compatible client. Claude, Cursor, VS Code, Claude Code, Codex, Gemini CLI, Windsurf, Zed, and LM Studio are named in the setup material or examples. Claude Code can install the project plugin, or it can add only the HTTP MCP server. Codex uses the same endpoint with its MCP command.

A local development setup is separate from using the hosted MCP service. It requires Bun, Cloudflare R2, Upstash Redis, and an OpenAI or OpenRouter API key. The documented flow is to clone the repository, run bun install, copy .env.example to .env, fill in the configuration, and start the application with bun run dev. The local web app is then available at localhost:3000.

Tools and capabilities

GitDiagram MCP server supports these documented agent-facing capabilities:

  • Read a public repository’s architecture explanation.
  • Retrieve identified components and connections.
  • Get the Mermaid source for a diagram.
  • Search diagrams stored by GitDiagram.
  • Get repository explainer videos.

The broader product can generate interactive architecture diagrams and narrated videos of about one minute. Existing videos can be watched, and downloadable MP4 output is available through the product interface. New video generation is described as early access.

Limitations and notes

The remote MCP service is documented for public repositories and has no key or sign-in requirement. Private repository support is documented for the website through a GitHub token, not explicitly for MCP. Local operation has additional infrastructure and API-key requirements that do not apply to the hosted endpoint.

Video explainers are disabled by default in a local deployment. Enabling them requires VIDEO_EXPLAINER_ENABLED=1, NEXT_PUBLIC_VIDEO_EXPLAINER=1, ANTHROPIC_API_KEY, OPENAI_API_KEY, and OPENROUTER_API_KEY.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GitDiagram

GitDiagram is an MCP server that connects AI agents to public GitHub repositories through a remote endpoint at gitdiagram.com/mcp. Its tools read architecture explanations, components, connections, and Mermaid source, search stored diagrams, and retrieve explainer videos. It requires no key or sign-in for the remote service.

Add https://gitdiagram.com/mcp as a remote MCP server in your client. Claude Code, Codex, Cursor, VS Code, and Gemini CLI have documented commands or install links; other supported clients can use the same remote URL.

Yes, GitDiagram works with Cursor through its remote MCP endpoint. Use the documented Cursor installation link or configure a remote MCP server with https://gitdiagram.com/mcp.

Private repositories are supported in the GitDiagram web interface when you provide a GitHub token through Private Repos.

GitDiagram can return an architecture explanation, components, connections, Mermaid source, stored-diagram search results, and explainer videos. These capabilities are available to agents through the remote MCP service for public repositories.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGitDiagram AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gitdiagram?style=directory)](https://allmcps.com/mcp/gitdiagram)
HTML Embed
<a href="https://allmcps.com/mcp/gitdiagram"><img src="https://allmcps.com/api/badge/gitdiagram?style=directory" alt="GitDiagram on AllMCPs" /></a>