minipuft/claude-prompts-mcp

**The portable workflow layer beside your AI coding harness.**
Your client executes with its own tools, agents, and context.
Claude Prompts adds reusable prompt resources, composable chains, validation gates, and client-native skill export.
Quick Start · What You Get · Compose Workflows · Run Anywhere · Docs
What your AI client gives you — and what this server adds
| Your client already does | This server adds |
| -------------------------- | ------------------------------------------------------------------------------------- |
| Run a prompt | Compose prompts with validation, reasoning guidance, and formatting in one expression |
| Single-shot skills | Multi-step workflows that thread context between steps |
| Execute subagents | Hand off mid-chain steps to agents with full workflow context |
| Client-native skill format | Author once as YAML, export to any client with skills:export |
| Manual prompt writing | Versioned templates with hot-reload, rollback, and history |
| Trust the output | Validate output between steps: self-evaluation and shell commands |
Is this for me?
- **Use this if** you write the same prompts repeatedly, run multi-step workflows, or want to share reusable prompts with a team.
- **Skip if** your client's built-in /commands already handle what you need, or you're looking for a no-code prompt library.
- **Works with** Claude Code, Claude Desktop, Cursor, OpenCode, Gemini CLI, Codex, Windsurf, and Zed. Plugin installers add hooks (chain tracking, gate enforcement, state preservation) for Claude Code, OpenCode, Gemini CLI, and Codex (experimental); other clients run MCP-only.
---
Quick Start
Claude Code (Recommended)
Development setup
Load plugin from local source for development:
Edit hooks/prompts → restart Claude Code. Edit TypeScript → rebuild first.
Codex (Experimental)
Codex hooks require Codex CLI 0.117 or later and are unavailable on Windows. See the codex-prompts requirements for Python and Node.js prerequisites.
Enable hooks in ~/.codex/config.toml:
Then install the plugin:
Restart Codex, run /hooks to review the plugin hooks, then try >>tech_evaluation_chain library:'zod' context:'API validation'.
---
More Client Setups
Claude Desktop
**Option A: GitHub Release** (recommended)
1. Download claude-prompts-{version}.mcpb from Releases
2. Drag into Claude Desktop Settings → MCP Servers
3. Done
The .mcpb bundle is self-contained (~5MB); no npm required.
**Option B: NPX** (auto-updates)
Add to your config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop and test: >>research_chain topic:'remote team policies'
Other clients : VS Code · Cursor · OpenCode · Gemini CLI · Windsurf · Zed · From Source
**Client setup:** VS Code, Cursor, and other MCP-only clients use the manual configuration guide below.
**Plugin installers** (recommended where available; adds hooks):
**Manual config** for VS Code, Cursor, OpenCode (no hooks), Gemini CLI (no hooks), Codex (no plugin hooks), Windsurf, and Zed: see Client Integration Guide for per-client config locations, JSON examples, and --client preset matrix. Client Capabilities Reference covers profile mapping and limits.
**From source** (developers):
Point your MCP config to server/dist/index.js. Transport: --transport=stdio (default) or --transport=streamable-http.
**Custom resources**: --init=~/my-prompts scaffolds a starter workspace: three example prompts plus config.jsonc. Edit them (YAML schema), or have your AI author new prompts, gates, and frameworks via resource_manager. Point MCP_RESOURCES_PATH at an existing workspace if you already have one in the right shape. See Custom Resources Guide.
---
What You Get
Four primitives you author, version, and compose. The bundled set ships 52 prompts across 9 categories — a starting library, not the ceiling: your AI writes new prompts and chains through resource_manager as it works, so the set grows around what you actually do. All hot-reloadable, all versioned with rollback.