BetterPrompt MCP Server


---

Table of Contents

- Overview
- Why BetterPrompt?
- Quickstart
- Installation
- Tools Summary
- Usage Examples
- Client Integration
- Auto-Apply Enhancement
- Development
- Best Practices
- Troubleshooting
- License
- Support

---

Overview

BetterPrompt MCP is a Model Context Protocol (MCP) server that automatically enhances user prompts using advanced prompt engineering techniques. It exposes a suite of tools for prompt transformation, code generation, analysis, and best practices, making it easy to get optimal results from AI models.

Instead of manually crafting detailed prompts, BetterPrompt MCP converts simple requests into structured, context-rich instructions tailored for your task and audience.

Before & After Example

Without BetterPrompt:

> "Write a function to calculate fibonacci numbers"

With BetterPrompt Enhancement:

> "Create a JavaScript function that calculates Fibonacci numbers using an efficient algorithm. Include error handling for invalid inputs, support for both iterative and recursive approaches, and clear documentation with time complexity analysis. Format the response with clear code examples and explanations."

---

Why BetterPrompt?

AI models respond much better to well-structured prompts with clear context and instructions. BetterPrompt applies proven prompt engineering techniques to transform your requests into optimal formats that:

- ✅ Increase accuracy - More precise responses with fewer hallucinations
- ✅ Improve structure - Organized, actionable output formats
- ✅ Add context - Relevant background information for better understanding
- ✅ Define constraints - Clear boundaries and requirements
- ✅ Specify success criteria - Know what constitutes a good response

BetterPrompt works with any MCP-compatible client, including VS Code, Cursor, Claude Desktop, LM Studio, and many others.

---

Quickstart

Install and run via npx:

``bash
npx -y betterprompt-mcp
`

Or add to your MCP client configuration:

`json
{
"mcpServers": {
"betterprompt": {
"command": "npx",
"args": ["-y", "betterprompt-mcp"]
}
}
}
`

Once installed, you can:

1. Call enhancement tools explicitly – Use the tools below for specific prompt, code, or analysis enhancement
2. Enable auto-prelude – Configure your client to automatically enhance every prompt (see Auto-Apply Enhancement)

---

Install in your coding agent

Most MCP clients work with this standard config:

`json
{
"mcpServers": {
"betterprompt": {
"command": "npx",
"args": ["-y", "betterprompt-mcp"]
}
}
}
`

Pick your client below. Where available, click the install button; otherwise follow the manual steps.

---

Tools

$3

General prompt enhancement using advanced prompt engineering techniques.

Input:

- prompt (string, required): The user request to enhance
- category (string, optional): One of general, code, analysis, creative, research

Output: AI-enhanced prompt with structure, context, and clear instructions.

Example Usage:

`json
{
"name": "enhance-prompt",
"arguments": {
"prompt": "Write a function to calculate fibonacci numbers",
"category": "code"
}
}
`

$3

Specialized enhancement for code generation prompts.

Input:

- prompt (string, required): The code-related request to enhance
- language (string, optional): Programming language or technology stack
- complexity (string, optional): beginner, intermediate, or advanced

Output: AI-enhanced code prompt with detailed requirements and context.

Example Usage:

`json
{
"name": "enhance-code-prompt",
"arguments": {
"prompt": "Write a Python function to sort a list of numbers",
"language": "Python",
"complexity": "advanced"
}
}
`

$3

Specialized enhancement for analysis prompts.

Input:

- prompt (string, required): The analysis request to enhance
- domain (string, optional): Specific domain or field of analysis
- depth (string, optional): overview, detailed, or comprehensive

Output: AI-enhanced analysis prompt with structured guidance.

Example Usage:

`json
{
"name": "enhance-analysis-prompt",
"arguments": {
"prompt": "Analyze the impact of climate change on polar bears",
"domain": "environment",
"depth": "comprehensive"
}
}
`

$3

Retrieve prompt engineering templates for various tasks.

Input:

- category (string, required): One of code-generation, technical-analysis, creative-writing, research-synthesis

Output: Prompt engineering template for the specified category.

Example Usage:

`json
{
"name": "get-template",
"arguments": {
"category": "code-generation"
}
}
`

$3

Get comprehensive best practices guide for prompt engineering.

Output: Detailed guide on best practices for writing effective prompts.

Example Usage:

`json
{
"name": "get-best-practices",
"arguments": {}
}
`

$3

View server performance statistics.

Output: Current server statistics including uptime, memory usage, and cache status.

Example Usage:

`json
{
"name": "server-stats",
"arguments": {}
}
`

$3

Clear enhancement cache.

Output: Confirmation of cache clearance.

Example Usage:

`json
{
"name": "clear-cache",
"arguments": {}
}
`

---

Usage Examples

$3

Request:

`json
{
"name": "enhance-prompt",
"arguments": {
"prompt": "Explain quantum computing",
"category": "analysis"
}
}
`

Enhanced Result:

> "Provide a comprehensive explanation of quantum computing for a technical audience. Cover fundamental concepts including qubits, superposition, entanglement, and quantum gates. Compare classical vs. quantum computing approaches. Include real-world applications and current limitations. Structure the response with clear headings and examples."

$3

Request:

`json
{
"name": "enhance-code-prompt",
"arguments": {
"prompt": "Create a React component for a todo list",
"language": "TypeScript",
"complexity": "advanced"
}
}
`

Enhanced Result:

> "Build a React component for a todo list application with the following features: add new todos, mark as complete, delete items, and filter by status (all/active/completed). Use modern React hooks (useState, useEffect) and ensure accessible HTML. Include proper TypeScript typing, CSS styling, and error handling. Provide a clean, user-friendly interface with responsive design."

$3

Request:

`json
{
"name": "enhance-analysis-prompt",
"arguments": {
"prompt": "Analyze the sales data for 2023",
"domain": "business",
"depth": "comprehensive"
}
}
`

Enhanced Result:

> "Perform a detailed analysis of the sales data for 2023. Identify key trends, seasonal patterns, and anomalies. Provide predictions for the next quarter based on historical data. Use visualizations like charts and graphs to illustrate findings. Ensure the analysis is actionable with clear recommendations."

---

Auto-Apply Enhancement

BetterPrompt offers a unique feature that automatically enhances every prompt without requiring manual tool calls.

$3

When you enable the betterprompt-default-prelude in your MCP client:

1. Every user request is internally enhanced using world-class prompt engineering techniques
2. The assistant applies the enhanced version to plan its reasoning
3. The assistant produces a superior result without mentioning the enhancement process
4. Your workflow remains simple - no need to call tools explicitly

$3

Many MCP clients allow selecting a prompt template to include at the start of a chat or session. BetterPrompt publishes:

- betterprompt-default-prelude

Enable this prompt in your client's "Prompts" or "Prelude/System" section to automatically apply BetterPrompt techniques to each user message.

Notes:

- The exact UI for enabling a default prompt varies by MCP client
- Look for a way to select or add a "prompt"/"system"/"prelude" entry for a server
- This approach works across MCP clients because it relies on standard prompts/list and get_prompt support

---

Best Practices

$3

To get the most out of BetterPrompt, consider these tips when crafting your initial prompts:

1. Be specific about the task: Instead of "explain databases", try "explain database normalization for a beginner"
2. Mention the audience: Include who the content is for (developers, managers, students, etc.)
3. Specify the format: Request specific output formats when helpful (bullet points, code, tables, etc.)
4. Include constraints: Mention any limitations like word count, technical level, or specific requirements
5. State the purpose: Explain what you'll use the information for

$3

Use Manual Enhancement (enhance-prompt tool) when:

- You want to see the enhanced prompt before using it
- You're working on critical tasks where you want to review the enhancement
- You only need to enhance specific prompts occasionally

Use Auto Enhancement (prelude) when:

- You want all prompts enhanced without extra steps
- You're doing exploratory work or brainstorming
- You prefer a seamless experience without manual tool calls

---

Troubleshooting

$3

Server not starting

- Ensure you have Node.js >= 18 installed
- Run npx -y betterprompt-mcp directly in your terminal to check for errors
- Confirm your MCP client supports stdio transport

Tool not appearing in client

- Verify the server is running and responding
- Check your MCP client configuration
- Restart your MCP client after adding the server

Auto-prelude not working

- Confirm your client supports the prompts/list and prompts/get MCP methods
- Ensure you've enabled the betterprompt-default-prelude prompt
- Some clients may require a restart after enabling prompts

$3

BetterPrompt logs enhancement activities and errors to stderr. If you encounter issues:

1. Check your MCP client's logs for error messages
2. Run the server directly to see console output:

`bash
npx -y betterprompt-mcp
`

3. Look for [INFO], [WARN], [ERROR], and [SUCCESS] log messages for diagnostics

---

Development

$3

`
betterprompt-mcp/
├── src/
│ └── index.ts # Main server implementation
├── tests/ # Test files and verification scripts
├── dist/ # Compiled output (generated)
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
└── README.md # Documentation
`

$3

Build:

`bash
npm run build
`

Watch (dev):

`bash
npm run watch
`

Format:

`bash
npm run format
npm run format:check
`

Test:

`bash
npm run test:comprehensive
``

License

MIT License

---

Support

For questions or issues, open an issue on GitHub or contact the author via GitHub profile.

---

Author

Aung Myo Kyaw (GitHub)