Claude Prompt Optimizer MCP server

Prompt Control Plane

The control plane for AI prompts. Score, enforce policy, lock config, and audit every prompt decision. Free tier included.

Quick Start

# Install globally (requires Node.js 20+)
npm install -g pcp-engine

# Pre-flight: classify, score, route, and enforce policy in one call
pcp preflight "your prompt here" --json

# Run the guided demo
pcp demo

Two powerhouse commands:

Supporting commands:

Free tier gives you 50 optimizations/month to try it out.

Try It

# Pre-flight a vague prompt: see why it scores low
pcp preflight "make the code better" --json

# Pre-flight a well-specified prompt: see the full analysis
pcp preflight "Refactor auth middleware in src/auth/middleware.ts to use JWT. Do not modify the user model." --json

# Run the full optimization pipeline (compile + blocking questions + approval)
pcp optimize "Build a REST API with auth" --json

# Quick quality check on all prompts in a directory
pcp check --file "prompts/**/*.txt"

# Run the guided demo
pcp demo

GitHub Action

# .github/workflows/prompt-quality.yml
- uses: rishi-banerjee1/prompt-control-plane@v5
  with:
    subcommand: preflight
    files: "prompts/**/*.txt"

Full GitHub Action configuration

# .github/workflows/pcp.yml
name: Prompt Quality Gate
on: [push, pull_request]
jobs:
  lint:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: rishi-banerjee1/prompt-control-plane@v5
        with:
          subcommand: preflight
          files: 'prompts/**/*.txt'
          threshold: 70
          comment: 'true'  # Posts results as PR comment

Run optimize in CI (full pipeline):

- uses: rishi-banerjee1/prompt-control-plane@v5
        with:
          subcommand: optimize
          files: 'prompts/**/*.txt'

This action expects your repo to be checked out (actions/checkout). Without it, file globs will match nothing.

SHA-pinned example (for enterprise users):

- uses: rishi-banerjee1/prompt-control-plane@abc123def  # SHA-pinned
        with:
          version: '5.0.0'  # Required when pinning by SHA
          files: 'prompts/**/*.txt'
          threshold: 70

Shortened. The full README is on GitHub.