Skip to main content
Glama

@merabylabs/promptarchitect-mcp

npm version MCP Compatible

A Model Context Protocol (MCP) server that refines your prompts using PromptArchitect's AI-powered prompt engineering. Simply pass your current prompt and get an improved version back.

Works with: Claude Desktop • VS Code (Copilot) • Cursor • Windsurf • Zed • JetBrains IDEs • Continue.dev • Cline

✨ Why PromptArchitect MCP?

🎯 Workspace-Aware Refinement

Unlike generic prompt tools, PromptArchitect understands your project context. When refining prompts, it considers:

  • Your tech stack — React, Node, Python, or whatever you're building with

  • Project structure — File organization, naming conventions, architecture patterns

  • Dependencies — Libraries and frameworks from your package.json/requirements.txt

  • Your original request — Ensures refined prompts stay aligned with your actual goal

This means prompts are tailored to your specific codebase, not generic boilerplate.

🚀 Key Benefits

  • No API key required — Free to use, powered by PromptArchitect backend

  • Works in your IDE — Integrates with your existing workflow via MCP

  • Context-aware — Prompts that understand your project conventions

  • Iterative refinement — Keep improving until it's perfect

Features

🛠️ Tools

Tool

Description

refine_prompt

Improve your current prompt based on feedback and your workspace context

analyze_prompt

Evaluate prompt quality with scores and improvement suggestions

generate_prompt

Transform a raw idea into a well-structured prompt tailored to your project

📦 Resources

  • Template Library: Reference templates for coding, writing, research, and analysis tasks

  • Category Collections: Browse templates by category for inspiration

Installation

npm install @merabylabs/promptarchitect-mcp

Or install globally:

npm install -g @merabylabs/promptarchitect-mcp

Usage

PromptArchitect MCP server works with any IDE or application that supports the Model Context Protocol. Below are configuration examples for popular editors.

No API key required! The MCP server uses the PromptArchitect backend API, so you don't need your own Gemini API key.


Claude Desktop

Add to your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "promptarchitect": { "command": "npx", "args": ["@merabylabs/promptarchitect-mcp"] } } }

VS Code (GitHub Copilot)

Add to your VS Code settings.json (Cmd/Ctrl+Shift+P → "Preferences: Open Settings (JSON)"):

{ "github.copilot.chat.mcp.servers": { "promptarchitect": { "command": "npx", "args": ["@merabylabs/promptarchitect-mcp"] } } }

Cursor

Add to your Cursor MCP settings:

  • macOS/Linux: ~/.cursor/mcp.json

  • Windows: %USERPROFILE%\.cursor\mcp.json

  • Or via: Settings → MCP

{ "mcpServers": { "promptarchitect": { "command": "npx", "args": ["@merabylabs/promptarchitect-mcp"] } } }

📖 Cursor MCP Documentation


Windsurf (Codeium)

Add to your Windsurf MCP configuration:

  • macOS/Linux: ~/.codeium/windsurf/mcp_config.json

  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

{ "mcpServers": { "promptarchitect": { "command": "npx", "args": ["@merabylabs/promptarchitect-mcp"] } } }

📖 Windsurf MCP Documentation


Zed

Add to your Zed settings:

  • macOS: ~/.config/zed/settings.json

  • Linux: ~/.config/zed/settings.json

{ "context_servers": { "promptarchitect": { "command": { "path": "npx", "args": ["@merabylabs/promptarchitect-mcp"] }, "settings": {} } } }

📖 Zed MCP Documentation


JetBrains IDEs

Works with IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand, RubyMine, CLion, DataGrip, Rider, Android Studio.

  1. Install the MCP Client plugin from JetBrains Marketplace

  2. Go to Settings → Tools → MCP Servers

  3. Add a new server with this configuration:

{ "mcpServers": { "promptarchitect": { "command": "npx", "args": ["@merabylabs/promptarchitect-mcp"] } } }

Or add to .idea/mcp.json in your project.

📖 JetBrains MCP Plugin


Continue.dev

Add to your Continue configuration:

  • Global: ~/.continue/config.json

  • Project: .continue/config.json

{ "experimental": { "modelContextProtocolServers": [ { "transport": { "type": "stdio", "command": "npx", "args": ["@merabylabs/promptarchitect-mcp"] } } ] } }

📖 Continue MCP Documentation


Cline (VS Code Extension)

Open Cline Settings → MCP Servers, or edit cline_mcp_settings.json:

{ "mcpServers": { "promptarchitect": { "command": "npx", "args": ["@merabylabs/promptarchitect-mcp"], "disabled": false } } }

📖 Cline MCP Documentation


Other MCP-Compatible Applications

Any application supporting MCP can use this server. The standard configuration is:

Property

Value

Command

npx

Args

["@merabylabs/promptarchitect-mcp"]

For global installation, use promptarchitect-mcp as the command after running:

npm install -g @merabylabs/promptarchitect-mcp

Programmatic Usage

import { refinePrompt, analyzePrompt } from '@promptarchitect/mcp-server'; // Refine an existing prompt const result = await refinePrompt({ prompt: 'Write code to sort an array', feedback: 'Make it more specific about language and edge cases', }); console.log(result.refinedPrompt); // => "Write a TypeScript function that sorts an array of numbers..." // Analyze prompt quality const analysis = await analyzePrompt({ prompt: 'Help me with my code', }); console.log(analysis.scores); // { overall: 45, clarity: 50, ... } console.log(analysis.suggestions); // ["Be more specific about...", ...]

Configuration

Environment Variables

Variable

Required

Description

LOG_LEVEL

No

Logging level:

debug

,

info

,

warn

,

error

. Default:

info

Tool Reference

refine_prompt

Improve an existing prompt based on feedback. This is the primary tool.

Input:

{ "prompt": "Write code", "feedback": "Make it more specific and add examples", "preserveStructure": true }

Output:

{ "refinedPrompt": "Write a TypeScript function that...", "changes": ["Added specificity", "Included example"], "metadata": { "originalWordCount": 2, "refinedWordCount": 45 } }

analyze_prompt

Evaluate prompt quality and get improvement suggestions.

Input:

{ "prompt": "You are a helpful assistant. Help me write code." }

Output:

{ "scores": { "overall": 65, "clarity": 70, "specificity": 50, "structure": 60, "actionability": 80 }, "suggestions": [ "Add more specific details about the code", "Include examples of expected output" ], "strengths": ["Clear action verb"], "weaknesses": ["Lacks specificity"] }

generate_prompt

Transform a raw idea into a well-structured prompt.

Input:

{ "idea": "Create a code review assistant", "template": "coding", "context": "For TypeScript projects" }

Output:

{ "prompt": "You are a senior code reviewer...", "metadata": { "template": "coding", "wordCount": 150, "hasStructure": true } }

Development

Building

npm install npm run build

Testing

npm test

Running Locally

npm start

Architecture

mcp-server/ ├── src/ │ ├── tools/ # MCP tools (refine, analyze, generate) │ ├── resources/ # Template library for reference │ ├── utils/ # Gemini client, logger │ ├── server.ts # MCP server configuration │ ├── cli.ts # CLI entry point │ └── index.ts # Main exports └── examples/ # Configuration examples

License

Proprietary - © 2025 Meraby Labs. All rights reserved.

This software is provided for use exclusively with the PromptArchitect service. Unauthorized copying, modification, distribution, or use outside the intended scope is prohibited.

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xXMSGXx/promptarchitect-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server