MDPilot MCP
OfficialAllows using Google's Gemini 2.0 Flash model for generating markdown and AI instructions through the MCP server.
Allows using NVIDIA NIM's Llama 3.3 70B instruct model for free-tier generation via the MCP server.
Allows using OpenAI's GPT-4o model for generating markdown and AI instructions through the MCP server.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MDPilot
Markdown intelligence platform — generate production-grade AI instruction files, optimize tokens, and convert any file to markdown. Works in the browser and as an MCP server inside your IDE.
mdpilot.in · Docs · MCP setup · VS Code extension · npm — mdpilot-mcp@0.3.4 · Changelog
What it generates
Mode | Input | Output |
Task (primary) | Ticket · Slack thread · spec | TASK.md + SPEC.md — structured, gap-checked, agent-ready |
Generate | 7-step wizard + tech stack | README · AGENTS · CLAUDE · CONTRIBUTING · SECURITY · SKILL · DESIGN · CONTEXT |
Convert | PDF · DOCX · CSV · HTML | Clean markdown via MarkItDown |
Explain | Code file or directory | WALKTHROUGH.md tuned to any audience |
Image → Prompt | Any image | Recreation prompt for FLUX / SD / Midjourney / DALL-E |
Interview primer | Role + level + JD | Ready-to-paste AI coach prompt |
Every output runs through a 5-pass token optimizer (20–40% reduction) and a self-verification loop that checks generated commands against your real repo before writing anything.
DESIGN.md follows the getdesign.md / awesome-design-md ecosystem spec — 9 sections in fixed order (Visual Theme → Agent Prompt Guide) so any design tool or AI agent that reads DESIGN.md files gets exact tokens, not guessed values.
Agent behavior directives (v0.3.1):
Human voice (
writingStyle: 'human') — natural prose for README, CONTRIBUTING, DESIGN; auto-enabled for non-technical and learner audiences; hard-ignored for agent files (AGENTS.md, CLAUDE.md, SKILL.md).Plan-first (ai_exec mode) — generated agent prompts now always open with "Before executing: write a 3-5 line plan" + step-verify gates before the Response style line.
Agent risk check (ai_exec + riskCheck toggle) — appends "check your plan against the Watch-outs above" to the agent prompt block when Watch-outs are present.
Related MCP server: claude-init
VS Code extension — no config required
Install the MDPilot extension from the VS Code Marketplace. Works in VS Code, Cursor, and Windsurf. No JSON MCP config — just install, and the extension auto-reads your existing API key from ~/.cursor/mcp.json, ~/.claude/mcp.json, or env vars.
A sidebar panel gives you a Chat tab (type generate agents, check drift, task: …) and a Settings tab (provider, encrypted key, status) — or use the command palette:
Ctrl+Shift+P → MDPilot: Generate AGENTS.mdCommand | What it does |
| Verified AGENTS.md, written to disk |
| CLAUDE.md for Claude Code / Cursor |
| Ticket → TASK.md |
| Flags stale commands and paths |
| Persist session state across AI sessions |
| Provider, key, and connection status in the panel |
Extension setup → · Marketplace →
MCP server — use MDPilot from inside your IDE
The mdpilot-mcp npm package exposes all 10 tools directly to Claude Code, Cursor, Windsurf, and Goose. The server reads your actual repo on disk — generated files reference real scripts and paths, never guesses.
One-command setup (gets you a free key + writes the config):
npx -y mdpilot-mcp setupOr non-interactively:
npx -y mdpilot-mcp setup --key gsk_... --client claudeManual config (any MCP-compatible client):
{
"mcpServers": {
"mdpilot": {
"command": "npx",
"args": ["-y", "mdpilot-mcp"],
"env": { "GROQ_API_KEY": "gsk_..." }
}
}
}Accepted keys (tried in order — Groq and NVIDIA are free):
GROQ_API_KEY · NVIDIA_API_KEY · ANTHROPIC_API_KEY · OPENAI_API_KEY
10 MCP tools
Tool | What it does |
| Scan repo — detects stack, scripts, package manager, structure, MCP servers |
| Generate any instruction file grounded in real repo data |
| Turn a ticket or thread into a structured TASK.md |
| Generate WALKTHROUGH.md for any file or directory |
| Run the 5-pass optimizer (+ opt-in aggressive 6th pass) on any markdown |
| Analyze an image → recreation prompt |
| Detect stale docs — broken commands, broken paths, removed MCP servers |
| Patch only the stale sections, preserve everything else |
| Persist session state to CONTEXT.md (last 5 sessions, secret-redacted) |
| Load prior session context + annotate stale references inline |
Session memory quick-start — your data never leaves your machine:
# End of session:
"Use mdpilot to save our session context — decisions: X, next steps: Y"
# Start of next session:
"Load the project context via mdpilot"Multi-model
Provider | Model | Notes |
Anthropic | claude-sonnet-4-6 | Best instruction-file quality |
Groq | llama-3.3-70b-versatile | Free tier — recommended default |
NVIDIA NIM | meta/llama-3.3-70b-instruct | Free tier |
OpenAI | gpt-4o | |
gemini-2.0-flash |
Quick local setup
git clone https://github.com/get-mdpilot/MDPilot-mcp
cd MDPilot-mcp/mdpilot
npm install
cp .env.example .env.local # add at least one AI key
npm run dev # http://localhost:3000MCP server:
cd packages/mcp
npm install && npm run build
npm run inspect # MCP Inspector — test tools interactivelySee DEVELOPMENT.md for full architecture, file trees, environment variables, and contribution guide.
Stack
Next.js 16 · TypeScript · Tailwind CSS v4 · Supabase · @modelcontextprotocol/sdk · repomix · js-tiktoken · zod
Legal
Operated by Viveon Gizit Pvt Ltd · Bengaluru, India — Product Owner: Mohan
Privacy Policy · Terms of Service · Report an issue
MIT license
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
FixMyPrompt is a remote MCP server for coding agents. It saves the steps your agent worked out as project memories and fetches them in later sessions, scores and rewrites prompts, and checks CLAUDE.md and AGENTS.md files. Works with Claude Code, Codex and Cursor. Free plan available.
Research-backed lint + generation for agent context files (CLAUDE.md, AGENTS.md) + prompt enhancer.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Source-checked CLI guides and model-aware planning for Claude Code, Codex, and Grok Build.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server that gives AI coding agents on-demand access to private project docs via BM25 ranked search. One setup for Claude Code, Cursor, Codex, Gemini CLI, and more. Docs stay private, never in public repos.1516Apache 2.0
- AlicenseAqualityCmaintenanceGenerates AI context files (CLAUDE.md, AGENTS.md, Cursor/Windsurf/Cline/Continue/Kilo Code/Trae rules, GEMINI.md, Copilot, Aider, Junie, Warp) for any repository. Runs as CLI or MCP server, 100% local.346 npm1MIT

Doc Bridgeofficial
AlicenseNot gradedqualityAmaintenanceTurn repository documentation into deterministic, executable handoffs for coding agents through MCP, CLI, and CI—without an LLM or API key.12,244 npm10MIT- AlicenseNot gradedqualityBmaintenanceLocal MCP server that gives AI agents a project constitution (LAWS.md), a code graph (Compass), and a spec-driven workflow — all 100% local with no LLM or cloud.115 npm3MIT