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

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.md

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 setup

Or non-interactively:

npx -y mdpilot-mcp setup --key gsk_... --client claude

Manual 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

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

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:3000

MCP server:

cd packages/mcp
npm install && npm run build
npm run inspect               # MCP Inspector — test tools interactively

See 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