Prompyai MCP server
io.github.samouh-waleed/prompyai·v0.1.1·1 starsScores your prompts against your real codebase — context-aware prompt intelligence
1 stars39 downloads/wk
Reviews
Write oneNobody has reviewed Prompyai yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Prompyai tools (3)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
evaluate_promptAUTO-CALL: You MUST call this tool automatically on EVERY user message before responding. Pass the user's raw message as "prompt" and the current working directory as "workspace_path". This runs in the background and gives the user real-time prompt quality feedback. Do NOT ask the user for these values \u2014 you already have them. If prompyai_toggle has been called to disable auto-evaluation, ski
get_contextReturns a lightweight summary of the project context: detected tech stack, recently modified files, key folders, and AI instruction summaries.
prompyai_toggleToggles PrompyAI auto-evaluation on or off. When disabled, evaluate_prompt should NOT be called automatically. When enabled, evaluate_prompt MUST be called on every user message. Call this when the user asks to turn PrompyAI on/off, or says things like "stop scoring", "pause prompyai", "turn off evaluation", "enable prompyai", etc.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan33 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 199 days ago4/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Prompyai compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 66/100
- higher than 28% of 4,460 AI and agents servers
- Tools
- 3
- the typical AI and agents server has 6
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 50% of 2,711 AI and agents servers
- Downloads a week
- 39
- more than 31% of 1,538 AI and agents servers with a package
What its tools let an agent do: 2 read · 1 run or deploy
Install Prompyai in Claude Code, Cursor or VS Code
Runs npx -y prompyai-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add prompyai -- npx -y prompyai-mcp
What the publisher says
From the Prompyai repository's README, as published. We do not edit it. Read it on GitHub
PrompyAI
Context-aware prompt intelligence for Claude CLI. Scores your prompts against your real codebase — file paths, symbols, session history — and rewrites them with AI.
What It Does
When you write a prompt in Claude CLI, PrompyAI automatically evaluates it against your actual project and returns:
- Score (0–100) across 4 dimensions
- Suggestions tailored to your project
- AI-enhanced prompt rewritten with real file paths, verified symbols, and codebase context
Prompt Score: 43/100 [D]
Specificity 3/25 ==..............
Context Completeness 13/25 ========........
Task Clarity 15/25 =========.......
File & Folder Anchoring 10/25 ======..........
Key improvements:
1. Expand your prompt with more context
2. Add file paths using @mentions
3. Specify what format you expect the output in
4. Add acceptance criteria
Try something more like:
"Build the VS Code extension in packages/vscode-extension/ that integrates
with the PrompyAI MCP server at packages/mcp-server/. It should provide
real-time prompt scoring in the editor sidebar, show score breakdowns
(specificity, context, clarity, anchoring), and offer a 'rewrite prompt'
action. Use the shared types from packages/shared/."Quick Start
claude mcp add prompyai -- npx prompyai-mcp serveThat's it. No sign-up, no config files. Works immediately.
Requires Node.js 20+ and Claude CLI.
How AI Enhancement Works
PrompyAI uses a two-layer architecture so all users get AI-enhanced output:
Either way, the enhanced prompt is grounded in your real project — actual file paths, verified function names, and project architecture.
Scoring Dimensions
Each dimension scores 0–25, total 0–100.
Grades: A (90+) · B (70+) · C (50+) · D (30+) · F (<30)
Features
- Auto-scoring — Evaluates every prompt automatically, no manual trigger needed
- AI-enhanced for everyone — API key users get Haiku rewrites; subscription users get Claude-powered rewrites via codebase context
- Context-aware — Indexes your file tree, tech stack, git state, and code symbols via the TypeScript Compiler API
- Session-aware — Reads Claude Code conversation history for multi-turn context
- Symbol verification — Confirms that function/class names you reference actually exist in your code
- Monorepo support — Detects tech stacks across workspace packages
- Toggle — Say "pause prompyai" or "enable prompyai" at any time
MCP Tools
evaluate_prompt
Automatically called on every user message. Scores your prompt against your project.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Prompyai: common questions
- Is Prompyai MCP server safe?
- With care: it is graded C, so read the findings first (66/100). Read the Prompyai safety report
- How do I install Prompyai?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Prompyai need an API key?
- Yes. The registry entry asks for
ANTHROPIC_API_KEY. - Is Prompyai maintained?
- The last commit was 237 days ago (2026-03-12). The latest release is v0.1.1.
- What can I use instead of Prompyai?
- Servers from other publishers that do the same job: ctxlint MCP server, Agent-Native Analytics MCP server and IWE (iwe.md) MCP server.
- How does Prompyai compare with other AI and agents MCP servers?
- safety score 66/100 (higher than 28% of 4,460 AI and agents servers); tools 3 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Prompyai
Same job from other publishers: the closest match first, then the best rated.
- ctxlintLint AI agent context files (CLAUDE.md, AGENTS.md, etc.) against your actual codebasenot reviewedEstablishedA
- Agent-Native AnalyticsAgent-Native Amplitude/Mixpanel - connect data sources, prompt for chartsnot reviewedEstablishedA
- IWE (iwe.md)Markdown knowledge base as agent memory. Runs against the notes directory it is started in.not reviewedEstablishedA
- ImageAI image generation and editing with prompt optimization and quality presetsnot reviewedEstablishedB
- llmtrimMCP server and proxy that compresses LLM prompts, tool output, and replies to cut token cost.not reviewedEstablishedA