Claude Prompts Mcp

What your AI client gives you — and what this server adds

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)

# Add marketplace (first time only)/plugin marketplace add minipuft/minipuft-plugins
# Install/plugin install claude-prompts@minipuft
# Try it>>tech_evaluation_chain library:'zod' context:'API validation'

git clone https://github.com/minipuft/claude-prompts-mcp ~/Applications/claude-prompts-mcpcd ~/Applications/claude-prompts-mcp/server && npm install && npm run buildclaude --plugin-dir ~/Applications/claude-prompts-mcp

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:

[features]hooks = true

Then install the plugin:

codex plugin marketplace add https://github.com/minipuft/minipuft-plugins.gitcodex plugin add codex-prompts@minipuft

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

{  "mcpServers": {    "claude-prompts": {      "command": "npx",      "args": ["-y", "claude-prompts@latest", "--client", "claude-code"]    }  }}

Restart Claude Desktop and test: >>research_chain topic:'remote team policies'

# OpenCode (full hooks)npm install -g opencode-prompts && opencode-prompts install
# Gemini CLI (partial hooks)gemini extensions install https://github.com/minipuft/gemini-prompts

git clone https://github.com/minipuft/claude-prompts-mcp.gitcd claude-prompts-mcp/server && npm install && npm run build && npm test

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. Resources that belong to one repository go in .claude-prompts/ at its root (cpm init --project scaffolds it) and load above your workspace over STDIO. 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.

Prompts, gates, and frameworks are managed through the resource_manager tool. Your AI creates, edits, versions, and rolls them back through MCP, no file editing required. Styles are managed with the bundled cpm CLI. Failed gate checks can retry automatically or pause for your decision (Gates Guide). Build your first primitive: Prompt Authoring Tutorial.

The Three Tools

Everything above reaches your client through three MCP tools:

Most users invoke these via >> syntax in conversation; hooks construct the actual calls. For programmatic MCP clients calling tools directly, see MCP Tools Reference.

Compose Workflows

How to write a chain

>>review target:'src/auth/' ^ReACT :: 'cite sources'  --> security_scan :: verify:"npm test"  ==> implementation

Read top-to-bottom:

• >>review target:'src/auth/' runs the review prompt against your auth folder.
• ^ReACT overlays the ReACT reasoning framework on this step.
• :: 'cite sources' adds a gate the AI must satisfy (cite sources, or retry).
• --> security_scan :: verify:"npm test" chains to step 2, which must pass npm test before producing output.
• ==> implementation hands the final step off to a client-native agent (a subagent in Claude Code).

review ships with the server; security_scan and implementation stand in for prompts you write.

Validation runs between steps, not only at the end. For the full operator grammar and examples, see MCP Tools Reference.

Two patterns extend the basic syntax. Chains also support context threading between steps and agent handoffs. See Chains Lifecycle and MCP Tools Reference.

Verification Loops

Ground-truth validation via shell commands. The AI keeps iterating until tests pass:

>>implement-feature :: verify:"npm test" loop:true

Implements, runs the test, reads failures, fixes, retries. Spawns a fresh context after repeated failures to avoid context rot.

implement-feature stands for your own prompt: :: verify attaches to any of them.

For autonomous test-fix cycles with context-rot prevention: Ralph Loops Guide.

Judge Mode

Let the AI pick the right resources for the task:

%judge Help me refactor this authentication module

Analyzes available templates, reasoning frameworks, validation rules, and styles, then recommends the best combination. You confirm before it runs. For scoring and overrides see Judge Mode Guide.

Run Anywhere

Author workflows as YAML templates. Export as native skills to your client.

# skills-sync.yaml — choose what to exportregistrations:  claude-code:    user:      - prompt:development/review      - prompt:development/validate_work

npm run skills:export

The review prompt becomes a /review Claude Code skill. validate_work becomes /validate_work. Same source, native experience; no MCP call required at runtime.

Compiles to native skill packages for Claude Code, Cursor, Codex and OpenCode. npm run skills:diff flags when exports drift from source. Configuration, supported clients, and drift detection: Skills Sync Guide.

With Hooks

Without hooks, you're calling the three MCP tools explicitly (the LLM constructs each call). With hooks, the operators work in conversation: >>, -->, ==>, :: feel native rather than mediated, and workflow state survives across LLM turns and context compaction.

What hooks unlock:

Hooks ship with the plugin install. Full support on Claude Code (this repo) and OpenCode; partial on Gemini CLI; experimental on Codex, where Codex hooks are off by default and each install requires a one-time /hooks trust review. Other clients get the three MCP tools but no hook-driven behaviors. Detail: hooks/README.md.

How It Works

Command with operators → server parses and injects resources (framework, gates, style) → client executes the rendered prompt and self-evaluates against the gates → router decides: next step on pass, retry on fail, return on done.

Full request lifecycle, pipeline stages, and subsystem diagrams: Architecture Overview.

Documentation

Choose a guide based on what you want to do: learn by building, complete a task, look up syntax, or understand the design.

→ docs/README.md

Quick jumps: Build your first prompt · Chains lifecycle · MCP Tools reference · Architecture overview · Troubleshooting

Contributing

cd servernpm installnpm run build        # esbuild bundles to dist/index.jsnpm test             # Run test suitenpm run validate:all # Full CI validation

The build produces a self-contained bundle. server/dist/ is gitignored, and CI builds fresh from source.

See CONTRIBUTING.md for workflow details.

License

MIT