nushey avatar

AGENTS.md Generator

nushey/agents-md-generator

Scans your codebase with tree-sitter and generates AGENTS.md files that follow the agents.md standard for AI coding agents. Exposes three tools: generate_agents_md runs the full pipeline with embedded writing rules, scan_codebase provides pure architectural context without the AGENTS.md mandate, and read_payload_chunk streams results in chunks to avoid overwhelming the MCP wire. Handles incremental scanning by caching parsed symbols and tracking file hashes, so only changed files get re-parsed on subsequent runs. Supports Python, C#, TypeScript, JavaScript, and Go. Stores all cache and payload artifacts outside your project directory using a hash of the project path. Ships with a setup wizard that detects Claude Code, Gemini CLI, Cursor, and Windsurf, then patches their config files automatically.

GitHub stars
6
tools
3
transport
STDIO
last updated
Sep 14, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

generate_agents_mdMain entry point. Runs the pipeline internally, embeds writing rules into the payload, and returns chunked read instructions.

Main entry point. Runs the pipeline internally, embeds writing rules into the payload, and returns chunked read instructions.

No parameter schema in public metadata yet.

scan_codebaseStandalone context tool. Analyzes the codebase and returns a pure data payload with no AGENTS.md mandate.

Standalone context tool. Analyzes the codebase and returns a pure data payload with no AGENTS.md mandate.

No parameter schema in public metadata yet.

read_payload_chunkStreams the payload written by either tool in chunks until has_more is false.

Streams the payload written by either tool in chunks until has_more is false.

No parameter schema in public metadata yet.

Sponsors

Readme

agents-md-generator

MCP server that analyzes codebases with tree-sitter and generates AGENTS.md files.

PyPI Python License: MIT MCP

Python · C# · TypeScript · JavaScript · Go

Installation · Usage · Configuration · How It Works · Contributing



View the full README on GitHub

Details

Repository
github.com/nushey/agents-md-generator
Package
agents-md-generator
Transport
STDIO
Registry
MCP registry, active