Prompt Refiner MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Prompt Refiner MCP Server Refine my idea: 'build a task manager app'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Prompt Refiner MCP Server
A Model Context Protocol server that helps systematically refine vague ideas into well-structured prompts through guided clarification.
Philosophy
This server follows the Sequential Thinking pattern:
Server provides STRUCTURE - tracks refinement steps, formats output, applies templates
Claude provides INTELLIGENCE - analyzes ideas, asks questions, decides when complete
Single focused tool with clear workflow
Visual progress feedback via colored stderr output
Related MCP server: PromptArchitect MCP
Installation
npm install
npm run buildUsage
Run Locally
node dist/index.jsAdd to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"promptrefiner": {
"command": "node",
"args": ["/Users/nmelo/Desktop/Projects/prompter/dist/index.js"]
}
}
}Docker (Optional)
docker build -t promptrefiner .
docker run -i promptrefinerHow It Works
The Tool: promptrefiner
Three modes:
Start - Begin refinement with original idea
{ originalIdea: "I want to build an API" }Clarify - Add clarifications for specific aspects
{ aspect: "purpose", clarification: "REST API for user authentication with JWT tokens" }Export - Generate refined prompt using a template
{ exportTemplate: "technical-spec", refinementComplete: true }
Aspects to Clarify
purpose (critical) - What is this for? What problem does it solve?
audience (critical) - Who will use this? Skill level?
constraints (important) - Requirements, limitations, technical constraints
context (important) - Where/when/how will this be used?
success (important) - How is success measured? What does "done" look like?
scope (helpful) - What's in/out of scope?
style (optional) - Tone, format, style preferences
Templates
detailed-structured - Comprehensive with sections (Purpose, Audience, Requirements, etc.)
concise-bullets - Brief bullet-point format
technical-spec - Formal specification style
conversational - Natural language paragraph
minimal - Just the essentials
Example Session
User: Help me refine this idea: "I want to build an API"
Claude: [calls promptrefiner with originalIdea]
šÆ Starting Refinement
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Original Idea ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā¤
ā I want to build an API ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Claude: Let me ask some clarifying questions:
- What will the API do? What's its main purpose?
- Who will use this API?
- Are there any technical requirements?
User: It's for user authentication. Developers will integrate it.
Needs JWT tokens and should handle 1000 requests/sec.
Claude: [calls promptrefiner with aspect="purpose", clarification="..."]
š Step 2: Clarifying Purpose
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā REST API for user authentication ā
ā using JWT tokens ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Step 2/5 | Covered: 1 aspect
[... more clarifications ...]
Claude: [calls promptrefiner with exportTemplate="technical-spec", refinementComplete=true]
⨠Step 5: Exported as technical-spec
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Template: technical-spec ā
ā Aspects covered: 3 ā
ā Total steps: 5 ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Claude: Here's your refined prompt:
# Specification
**Purpose**: User authentication API using JWT tokens, handling login,
logout, and token refresh
**Target Users**: Developers integrating authentication into their applications
**Technical Requirements**: Handle 1000 requests per second, JWT token-based
authentication
**Deployment Context**: Not specified
**Acceptance Criteria**: Functional implementationFeatures
ā Structured workflow - Systematic refinement process ā Multiple clarifications - Can clarify same aspect multiple times (concatenated) ā Visual progress - Colored console output with progress tracking ā Flexible templates - 5 built-in export formats ā Type-safe - Full TypeScript with strict validation ā oneOf schema - Enforces correct tool usage modes
Environment Variables
DISABLE_PROGRESS_LOGGING=true- Disable colored stderr output
Architecture
346 lines of TypeScript
Single tool with oneOf validation
5 template functions using template literals
State tracking via refinement history array
Duplicate handling - Multiple clarifications per aspect concatenated with
\n\n
Development
npm run watch # Watch mode during development
npm run build # Build for productionLicense
MIT
Available Tools
1 toolpromptrefinerA
A tool for systematically refining vague ideas into well-structured prompts.
This tool helps you work with users to transform rough ideas into clear, actionable prompts through a structured clarification process.
Workflow:
START: Submit the user's original idea
CLARIFY: Ask the user questions and submit clarifications for key aspects:
purpose: What is this for? What problem does it solve?
audience: Who will use this? What's their skill level?
constraints: What are the requirements, limitations, or technical constraints?
context: Where/when/how will this be used? What environment?
success: How will success be measured? What does "done" look like?
scope: What's included? What's explicitly out of scope?
style: What tone, format, or style is needed?
EXPORT: When refinement is complete, export using a template
Key aspects to explore (ask about these):
purpose (critical)
audience (critical)
constraints (important)
context (important)
success (important)
scope (helpful)
style (optional)
You decide what questions to ask based on what's unclear in the idea. You decide when enough clarification has been gathered. The tool just tracks your refinement steps and formats the output.
Available export templates:
"detailed-structured": Comprehensive with sections (Purpose, Audience, Requirements, etc.)
"concise-bullets": Brief bullet-point format
"technical-spec": Formal specification style
"conversational": Natural language paragraph
"minimal": Just the essentials
Inputs: aspect, originalIdea, clarification, exportTemplate, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 1 tool
With only a single tool, there is no possibility of confusion between tools. The tool's purpose is clearly defined and distinct.
The single tool name 'promptrefiner' is clear and descriptive. While it doesn't follow a verb_noun pattern, consistency is trivially maintained with only one tool.
The server has exactly one tool, which feels thin. However, the tool's purpose is narrowly scoped (prompt refinement), and the single tool encapsulates a complete workflow, making the count borderline but not extreme.
The tool covers the full prompt refinement lifecycle: start, clarify, and export with multiple templates. It appears functionally complete for its domain, though additional utilities (e.g., listing previous refinements) could be imagined.
Maintenance
Related MCP Connectors
Turn rough ideas into structured prompts for ChatGPT, Claude, Gemini, image and video AI.
A prompt engineer you talk to. It writes prompts, sharpens yours, and keeps them on your shelf.
Turns rough requests into sharp Role/Task/Context/Format prompts. Thai and English.
Turn a rough request into a specialized prompt using your saved profile and business context.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnhances and cleans raw prompts using AI to make them more clear, actionable, and effective. Provides quality assessment, suggestions, and supports both general and code-specific optimization modes.1MIT
- FlicenseAqualityCmaintenanceRefines and improves AI prompts using workspace-aware context from your project's tech stack, structure, and dependencies. Includes tools to analyze prompt quality and generate well-structured prompts from raw ideas.4209 npm5-
- AlicenseNot gradedqualityBmaintenanceRefines and optimizes prompts for LLMs through adaptive questioning and intelligent clarification workflows. Supports multiple AI providers (Google, OpenAI, Anthropic, Groq, Qwen) with interactive prompt enhancement and targeted modifications.18 PyPI17MIT
- AlicenseBqualityDmaintenanceEnables users to enhance rough prompts into more detailed, clear, and effective versions using multiple AI providers like Anthropic, OpenAI, and Gemini. Supports custom templates and integrates with any MCP-compatible client.166 npmApache 2.0