Borrowing it
Nothing to install: this file belongs to Jah-yee/diagrams-mcp-server. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/Jah-yee/diagrams-mcp-server/main/AGENTS.mdgit clone --depth 1 https://github.com/Jah-yee/diagrams-mcp-serverWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/jah-yee/diagrams-mcp-server/agents-md)<a href="https://agentmods.dev/instructions/jah-yee/diagrams-mcp-server/agents-md"><img src="https://agentmods.dev/badge/instructions/jah-yee/diagrams-mcp-server/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/jah-yee/diagrams-mcp-server/agents-md"><img src="https://agentmods.dev/badge/instructions/jah-yee/diagrams-mcp-server/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.05053 | $0.05053 |
| Opus 5 | $0.02527 | $0.02527 |
| Sonnet 5 | $0.01011 | $0.01011 |
| Haiku 4.5 | $0.00505 | $0.00505 |
Grade A, and why
diagrams-mcp-server AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Runs shell commandslowCapability
Expected in a hook, worth knowing in a rule or an instructions file.
| **Dangerous calls** | `os.system`, `os.popen`, `pickle.loads`, `pickle.load`, `subprocess.*` | How it starts
The opening of the file, as written. The whole thing — 528 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md — Azure Diagram MCP Server
Comprehensive onboarding guide for AI agents and human contributors working on this repository.
Project Overview
Azure Diagram MCP Server is a Python Model Context Protocol (MCP) server that generates professional infrastructure and architecture diagrams using the diagrams package DSL. It has first-class Azure support and integrates with the GitHub Copilot SDK for natural language diagram generation.
Key capability: A user describes a diagram via the GitHub Copilot CLI or VS Code Copilot → the MCP server generates Python diagram code → executes it → returns a PNG image rendered in the MCP Apps viewer.
Repository Structure
diagrams-mcp-server/
├── microsoft/ # Main source package
│ └── azure_diagram_mcp_server/
│ ├── __init__.py # Package init, version string
│ ├── server.py # FastMCP server — tool registration + entry point
│ ├── diagram_tools.py # Core logic — diagram generation, examples, icon listing
│ ├── models.py # Pydantic models — request/response schemas, DiagramType enum
│ ├── scanner.py # Security scanner — AST analysis + Bandit integration
│ ├── copilot_client.py # Copilot SDK client — natural language diagram interface
│ └── viewer/
│ └── app.html # MCP Apps interactive diagram viewer (HTML/CSS/JS)
├── tests/
│ ├── conftest.py # Pytest fixtures — temp dirs, example code, dangerous code
│ ├── test_server.py # Server tool function tests (15 tests)
│ ├── test_diagram_tools.py # Diagram generation + example tests (28 tests)
│ ├── test_models.py # Pydantic model validation tests (12 tests)
│ ├── test_scanner.py # Security scanner tests (58 tests)
│ ├── test_copilot_client.py # Copilot SDK client tests (37 tests)
│ └── resources/example_diagrams/ # Runnable example diagram scripts
├── docs-site/ # VitePress documentation site
│ ├── .vitepress/config.ts # Site config — nav, sidebar, theme
│ ├── index.md # Home page with hero + features
│ ├── guide/
│ │ ├── getting-started.md # Quick start
│ │ ├── installation.md # Install methods (uv, pip, Docker)
│ │ └── examples.md # Diagram examples with code
│ └── public/ # Static assets (logos, favicons)
├── .github/workflows/
│ ├── ci.yml # CI — Ruff lint, Pyright types, Pytest (Python 3.12+3.13)
│ └── docs.yml # Docs — VitePress build + GitHub Pages deploy
├── .pre-commit-config.yaml # Pre-commit hooks (Ruff, Pyright, pytest on push)
├── Dockerfile # Multi-stage Docker build with Graphviz
├── pyproject.toml # Project metadata, dependencies, tool config
└── uv.lock # Dependency lockfile (uv package manager)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 528 lines · 5,053 tokens per session scan A 6e96d67835a2
diagrams-mcp-server AGENTS.md is an instructions file published in the GitHub repository Jah-yee/diagrams-mcp-server (0 stars, last pushed 6mo ago), licensed MIT. It adds 5,053 tokens to every session, about $0.0253 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
spec-kit AGENTS.md
AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).