GitDiagramBLOCK
Visualize any GitHub codebase: free interactive architecture diagrams and one-minute explainer videos. Replace 'hub' with 'diagram' in any GitHub URL.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Visualize any codebase: turn any public or private GitHub repository into an interactive architecture diagram, or watch it explained in a one-minute narrated video. AI agents can use it too, through the MCP server or the Markdown version of any diagram (gitdiagram.com/owner/repo.md).
[Try GitDiagram →](https://gitdiagram.com/) · Or replace hub with diagram in any GitHub repository URL.
[](https://gitdiagram.com/)
[](LICENSE) [](https://ko-fi.com/ahmedkhaleel2004)
Sponsored SMS, WhatsApp, and RCS through one API. Try Sent →
New: explainer videos
GitDiagram can now turn a repository into a narrated video of about a minute. The video starts with what the project is for and what people do with it, then shows briefly how its main parts fit together and one decision under the hood.
[](https://gitdiagram.com/ahmedkhaleel2004/gitdiagram/video)
- [Watch the gallery →](https://gitdiagram.com/videos) or add
/videoto any diagram URL, such asgitdiagram.com/owner/repo/video. - Download an MP4 in landscape or vertical (9:16), with captions burned in.
- Making new videos is in early access. Anyone can watch videos that already exist.
Features
- Watch a repository explained in a narrated video, or press Video on any diagram page.
- *
bba2a4fa4828OBSERVED · 2026-10-14Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add gitdiagram-render --env ANTHROPIC_ADMIN_KEY=${ANTHROPIC_ADMIN_KEY} --env ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} --env CACHE_KEY_SECRET=${CACHE_KEY_SECRET} --env CLOUDFLARE_API_TOKEN=${CLOUDFLARE_API_TOKEN} -- npx -y gitdiagram-render{
"mcpServers": {
"gitdiagram-render": {
"command": "npx",
"args": [
"-y",
"gitdiagram-render"
],
"env": {
"ANTHROPIC_ADMIN_KEY": "${ANTHROPIC_ADMIN_KEY}",
"ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
"CACHE_KEY_SECRET": "${CACHE_KEY_SECRET}",
"CLOUDFLARE_API_TOKEN": "${CLOUDFLARE_API_TOKEN}"
}
}
}
}Exposed tools (5)
3 read · 2 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
GitDiagram | read | Read selected repositories to generate architecture diagrams |
find_repository_diagrams | read | |
get_explainer_video | read | |
write_script | write | DIRECTOR only: submit the film |
write_shots | write | DESIGNER only: submit the exact shots for the beats you were assigned. |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | FAIL |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | FAIL |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (3 observation(s))
- Network
- declared (10 observation(s))
- Shell
- declared (5 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (25)
diagram-payload.ts
/.env" ... fetch(
The repository material (README, file tree, source excerpts) arrives between <repository_material> and </repository_material>. Pictures attached from the README, just before it, are repository materia
# origin on Vercel, http://127.0.0.1:$PORT in a production container.
const ORIGIN = process.env.STAGE_ORIGIN ?? "http://127.0.0.1:4599";
const origin = process.env.STAGE_ORIGIN ?? "http://127.0.0.1:4599";
const ORIGIN = process.env.STAGE_ORIGIN ?? "http://127.0.0.1:4599";
.prettierignore
.dev.vars.example
diagram-payload.test.ts
new Function("window", chunkReloadScript)(win);createHash("md5")createHash("sha1")"/.aws/credentials",
"/s3/.aws/config",
const { narrateBeats } = await import("../../src/server/explainer/narration");} from "../../src/server/explainer/voice-alignment";
expect(evidenceUrl("owner/repo", "../../evil/x.ts")).toBe(const root = new URL("../../", import.meta.url);const root = new URL("../../", import.meta.url);"169.254.169.254",
dns.set("inside.example.com", ["169.254.169.254"]);The same source can be redeployed to Railway later through `Dockerfile` and `railway.json`. Those files are an offline recovery recipe, not a live standby. The container uses Next.js standalone output
["api/service.go", "blob"],
["api/service.go", { sha: "a".repeat(40), size: 127_000 }],Gates applied: instruction_override, no_behavioural_pass.
bba2a4fa4828full audit observations/trust-audit/mcp-server/ahmedkhaleel2004__gitdiagram.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-14 | bba2a4fa4828 | BLOCK | D | 69 | first audit |
Questions
What is the GitDiagram MCP server?
Visualize any GitHub codebase: free interactive architecture diagrams and one-minute explainer videos. Replace 'hub' with 'diagram' in any GitHub URL.
What tools does GitDiagram expose?
5 in total: 3 read-only, 2 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is GitDiagram safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 3 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does GitDiagram need?
It reads ANTHROPIC_ADMIN_KEY, ANTHROPIC_API_KEY, CACHE_KEY_SECRET, CLOUDFLARE_API_TOKEN, CRON_SECRET, GLOBALPING_TOKEN, INDEXNOW_KEY, NEXT_PUBLIC_POSTHOG_KEY, OPENAI_API_KEY, OPENAI_COMPLIMENTARY_DAILY_LIMIT_TOKENS, OPENROUTER_API_KEY and PAGESPEED_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does GitDiagram run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as gitdiagram-render.
How current is this page?
The grade is for one exact copy of the source (bba2a4fa4828), read on 2026-10-14. The repository is watched and re-audited when it changes.