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-enhancement-mcp-server enhance this prompt: write a story about a dragon"
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.
An MCP (Model Context Protocol) server that enhances user prompts using AI. It takes a rough prompt and returns a more detailed, clear, and effective version. Works with any MCP-compatible client like Claude Desktop or Claude Code.
Install and set your API key:
export ANTHROPIC_API_KEY=sk-ant-...Add to your MCP client config (e.g. Claude Desktop):
{
"mcpServers": {
"prompt-enhancer": {
"command": "npx",
"args": ["-y", "prompt-enhancement-mcp-server"],
"env": {
"ANTHROPIC_API_KEY": "your-key-here"
}
}
}
}Use the enhance_prompt tool to improve any prompt.
Related MCP server: Refine Prompt
# Run directly with npx (recommended)
npx -y prompt-enhancement-mcp-server
# Or install globally
npm install -g prompt-enhancement-mcp-server
# Or install locally
npm install prompt-enhancement-mcp-serverProvider | Env Variable | Default Model |
Anthropic |
|
|
OpenAI |
|
|
OpenRouter |
|
|
Gemini |
|
|
OpenAI-compatible |
|
|
Set at least one API key as an environment variable.
# API keys (set at least one)
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
OPENROUTER_API_KEY=sk-or-...
GEMINI_API_KEY=...
# Optional settings
PROMPT_ENHANCER_DEFAULT_PROVIDER=anthropic # Which provider to use by default
PROMPT_ENHANCER_CONFIG=/path/to/config.json # Custom config file path
PROMPT_ENHANCER_LOG_LEVEL=info # debug, info, warn, errorCreate ~/.config/prompt-enhancer/config.json for model defaults, custom templates, or OpenAI-compatible endpoints:
{
"defaultProvider": "anthropic",
"providers": {
"anthropic": {
"model": "claude-sonnet-4-5-20250929",
"temperature": 0.7,
"maxTokens": 4096
},
"openai": {
"model": "gpt-4o"
},
"openrouter": {
"model": "anthropic/claude-sonnet-4-5-20250929",
"baseUrl": "https://openrouter.ai/api/v1"
},
"gemini": {
"model": "gemini-2.0-flash"
}
},
"templates": {
"default": "Generate an enhanced version of this prompt (reply with only the enhanced prompt - no conversation, explanations, lead-in, bullet points, placeholders, or surrounding quotes):\n\n${userInput}"
},
"options": {
"maxContextMessages": 10,
"contextTruncateLength": 500
}
}API keys are never stored in the config file -- always use environment variables.
enhance_promptThe server exposes a single MCP tool:
Parameter | Type | Required | Description |
| string | Yes | The prompt text to enhance |
| string | No | Provider to use ( |
| string | No | Model override (e.g. |
| array | No | Conversation history ( |
| string | No | Custom template. Use |
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"prompt-enhancer": {
"command": "npx",
"args": ["-y", "prompt-enhancement-mcp-server"],
"env": {
"ANTHROPIC_API_KEY": "your-key-here"
}
}
}
}Add to ~/.claude/claude_code_config.json or your project's .mcp.json:
{
"mcpServers": {
"prompt-enhancer": {
"command": "npx",
"args": ["-y", "prompt-enhancement-mcp-server"],
"env": {
"OPENAI_API_KEY": "your-key-here",
"PROMPT_ENHANCER_DEFAULT_PROVIDER": "openai"
}
}
}
}Override the default enhancement template via the config file or the template tool parameter:
{
"templates": {
"default": "Rewrite this prompt to be more specific and actionable:\n\n${userInput}"
}
}Or pass inline when calling the tool:
{
"text": "write a web app",
"template": "Add technical details and edge cases to this prompt:\n\n${userInput}"
}Connect to Ollama, LM Studio, vLLM, or any OpenAI-compatible API:
{
"providers": {
"openai-compatible": {
"baseUrl": "http://localhost:11434/v1",
"model": "llama3"
}
}
}Then use it:
{
"text": "write a function",
"provider": "openai-compatible"
}"Unsupported provider" error
Check that the provider name is one of: anthropic, openai, openrouter, gemini, openai-compatible.
"API key is required" / authentication errors Make sure the corresponding environment variable is set. API keys are loaded from env vars, not the config file.
Timeouts or rate limit errors The server retries transient errors up to 3 times with exponential backoff. If you're consistently hitting rate limits, try a different provider or model.
No output / server won't start
Check PROMPT_ENHANCER_LOG_LEVEL=debug for detailed logging. Logs go to stderr (MCP protocol reserves stdout for communication).
git clone <repo-url>
cd prompt-enhancement-mcp-server
npm install
npm run build
npm testApache-2.0
Enhances a user prompt using AI to make it more detailed, clear, and effective
Inputs: text (required), model, context, provider, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 1 tool
There is only one tool, so there is no possibility of misselection or overlap. Its purpose is unambiguous.
The single tool follows a clean verb_noun snake_case convention (enhance_prompt). No inconsistencies are possible with one tool.
One tool matches the narrowly stated purpose but is thin even for that scope. There is no room for variants (e.g. tone, length, format options) that a prompt-enhancement service would plausibly offer.
The core enhancement operation is covered, but the surface is a single dead-end call with no options for enhancement style, target format, or refinement iterations. Usable but notably shallow for the domain.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Your prompt library in any MCP client: list, fetch, save and version prompt templates.
Turn rough ideas into structured prompts for ChatGPT, Claude, Gemini, image and video AI.
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
