# Betterprompt Mcp

> MCP server for AI-enhanced prompt engineering and request conversion.

- **Type:** MCP server
- **Install:** `agentstack add mcp-aungmyokyaw-betterprompt-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AungMyoKyaw](https://agentstack.voostack.com/s/aungmyokyaw)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.2.1
- **License:** MIT
- **Upstream author:** [AungMyoKyaw](https://github.com/AungMyoKyaw)
- **Source:** https://github.com/AungMyoKyaw/betterprompt-mcp

## Install

```sh
agentstack add mcp-aungmyokyaw-betterprompt-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# BetterPrompt MCP Server

  

[](https://github.com/AungMyoKyaw/betterprompt-mcp/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/betterprompt-mcp)
[](https://modelcontextprotocol.io/)
[](https://nodejs.org/)
[](https://www.typescriptlang.org/)
[](https://opensource.org/licenses/MIT)

---

## Table of Contents

- [Overview](#overview)
- [Quickstart](#quickstart)
- [Installation](#installation)
- [Tool](#tool)
- [Usage Example](#usage-example)
- [Client Integration](#client-integration)
- [How It Works](#how-it-works)
- [Development](#development)
- [License](#license)
- [Support](#support)

---

## Overview

BetterPrompt MCP is a Model Context Protocol (MCP) server that enhances user requests using advanced prompt engineering techniques. It exposes a single, powerful tool that transforms simple requests into structured, context-rich instructions tailored for optimal AI model performance.

Instead of manually crafting detailed prompts, BetterPrompt MCP converts your requests into expertly engineered prompts that get better results from AI models.

**Before & After Example**

Without BetterPrompt:

> "Write a function to calculate fibonacci numbers"

With BetterPrompt Enhancement:

> "You are a world-class AI assistant with expertise in advanced prompt engineering techniques from top AI research labs like Anthropic, OpenAI, and Google DeepMind.

Your task is to provide an exceptional response to the following user request:

"Write a function to calculate fibonacci numbers"

Please enhance your response by:

1. Analyzing the intent and requirements behind this request
2. Applying appropriate prompt engineering techniques to ensure maximum effectiveness
3. Adding clarity, specificity, and structure to your approach
4. Including relevant context and constraints for comprehensive understanding
5. Ensuring optimal interaction patterns for complex reasoning tasks
6. Specifying the most appropriate output format for the task
7. Defining clear success criteria for high-quality results

Structure your response with clear headings, detailed explanations, and examples where appropriate. Ensure your answer is comprehensive, actionable, and directly addresses all aspects of the request."

---

## 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"]
    }
  }
}
```

---

## Installation

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.

VS Code

Click a button to install:

[](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522betterprompt%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522betterprompt-mcp%2522%255D%257D)
[](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522betterprompt%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522betterprompt-mcp%2522%255D%257D)

Fallback (CLI):

```bash
code --add-mcp '{"name":"betterprompt","command":"npx","args":["-y","betterprompt-mcp"]}'
```

[Docs: Add an MCP server](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server)

Cursor

Click to install:

[](https://cursor.com/en/install-mcp?name=BetterPrompt&config=eyJjb21tYW5kIjoibnB4IC15IGJldHRlcnByb21wdC1tY3AifQ%3D%3D)

Or add manually: Settings → MCP → Add new MCP Server → Type: command, Command: `npx -y betterprompt-mcp`.

LM Studio

Click to install:

[](https://lmstudio.ai/install-mcp?name=betterprompt&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImJldHRlcnByb21wdC1tY3AiXX0%3D)

Or manually: Program → Install → Edit `mcp.json`, add the standard config above.

Continue

Install button: TODO – no public deeplink available yet.

Manual setup:

1. Open Continue Settings → open JSON configuration
2. Add `mcpServers` entry:

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

Restart Continue if needed.

Goose

Click to install:

[](https://block.github.io/goose/extension?cmd=npx&arg=-y&arg=betterprompt-mcp&id=betterprompt&name=BetterPrompt&description=Enhance%20prompts%20with%20advanced%20techniques%20for%20MCP%20clients)

Or manually: Advanced settings → Extensions → Add custom extension → Type: STDIO → Command: `npx -y betterprompt-mcp`.

Claude Code (CLI)

Install via CLI:

```bash
claude mcp add betterprompt npx -y betterprompt-mcp
```

Claude Desktop

Add to `claude_desktop_config.json` using the standard config above, then restart Claude Desktop. See the MCP quickstart:

[Model Context Protocol – Quickstart](https://modelcontextprotocol.io/quickstart/user)

Windsurf

Follow the Windsurf MCP documentation and use the standard config above.

[Docs: Windsurf MCP](https://docs.windsurf.com/windsurf/cascade/mcp)

Gemini CLI

Follow the Gemini CLI MCP server guide; use the standard config above.

[Docs: Configure MCP server in Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#configure-the-mcp-server-in-settingsjson)

Qodo Gen

Open Qodo Gen chat panel → Connect more tools → + Add new MCP → Paste the standard config above → Save.

[Qodo Gen documentation](https://docs.qodo.ai/qodo-documentation/qodo-gen)

opencode

Create or edit `~/.config/opencode/opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "betterprompt": {
      "type": "local",
      "command": ["npx", "-y", "betterprompt-mcp"],
      "enabled": true
    }
  }
}
```

[opencode MCP documentation](https://opencode.ai/docs/mcp-servers/)

---

## Tool

### `enhance-request`

Transforms user requests into world-class AI-enhanced prompts using advanced prompt engineering techniques.

**Input:**

- `request` (string, required): The user request to transform into an enhanced AI prompt

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

**Example Usage:**

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

---

## Usage Example

**Request:**

```json
{
  "name": "enhance-request",
  "arguments": {
    "request": "Explain quantum computing"
  }
}
```

**Enhanced Result:**

> "You are a world-class AI assistant with expertise in advanced prompt engineering techniques from top AI research labs like Anthropic, OpenAI, and Google DeepMind.

Your task is to provide an exceptional response to the following user request:

"Explain quantum computing"

Please enhance your response by:

1. Analyzing the intent and requirements behind this request
2. Applying appropriate prompt engineering techniques to ensure maximum effectiveness
3. Adding clarity, specificity, and structure to your approach
4. Including relevant context and constraints for comprehensive understanding
5. Ensuring optimal interaction patterns for complex reasoning tasks
6. Specifying the most appropriate output format for the task
7. Defining clear success criteria for high-quality results

Structure your response with clear headings, detailed explanations, and examples where appropriate. Ensure your answer is comprehensive, actionable, and directly addresses all aspects of the request."

---

## How It Works

BetterPrompt MCP leverages the [MCP Sampling API](https://modelcontextprotocol.io/specification/2025-06-18/client/sampling) to enhance user requests:

1. When you call the `enhance-request` tool, the server sends a sampling request to your MCP client
2. Your client uses its configured LLM to enhance the prompt using advanced prompt engineering techniques
3. The enhanced prompt is returned to you for use with any AI model

This approach has several benefits:

- No API keys required - uses your client's existing LLM configuration
- Leverages the most capable model available in your client
- Works with any MCP-compatible client (Claude Desktop, VS Code, Cursor, etc.)
- Always up-to-date with the latest prompt engineering techniques

---

## Development

### Project Structure

```
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
```

### Build & Development

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
```

### Linting and Formatting

We use ESLint + Prettier to keep the codebase consistent.

- Run the linter locally: `npm run lint`
- Apply autofixes: `npm run lint -- --fix` or `npm run lint:fix`
- Run the CI-oriented lint (JSON output): `npm run lint:ci` (produces `artifacts/lint-report.json`)
- Autofix auto-commit policy: safe, formatting-only autofixes are auto-committed using `scripts/lint-autofix-and-commit.sh`. The script uses a conservative heuristic (small change threshold) and will abort auto-commit when changes appear large or potentially behavior-affecting; in such cases open a PR for human review.

## License

MIT License

---

## Support

For questions or issues, open an issue on [GitHub](https://github.com/AungMyoKyaw/betterprompt-mcp/issues) or contact the author via GitHub profile.

---

## Author

Aung Myo Kyaw ([GitHub](https://github.com/AungMyoKyaw))

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AungMyoKyaw](https://github.com/AungMyoKyaw)
- **Source:** [AungMyoKyaw/betterprompt-mcp](https://github.com/AungMyoKyaw/betterprompt-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.2.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.2.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-aungmyokyaw-betterprompt-mcp
- Seller: https://agentstack.voostack.com/s/aungmyokyaw
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
