npm package: @promzia/mcp-server
Description: Access 3000+ curated AI prompts directly in Claude, Cursor, Windsurf, and any MCP-compatible client
Author: Promzia Team
Latest version: 1.0.5

# Promzia MCP Server

Access 3000+ curated AI prompts directly in Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

## Features

- 🔍 **Search Prompts** - Find prompts by keyword, category, or type
- 📋 **Get Full Details** - Access complete prompt templates with variables  
- 💡 **Smart Suggestions** - Get context-aware prompt recommendations
- ⚡ **Quick Fill** - Replace variables and get ready-to-use prompts
- 🔓 **Unlock Premium** - Access premium prompts with free daily views

## Installation

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

```json
{
  "mcpServers": {
    "promzia": {
      "command": "npx",
      "args": ["-y", "@promzia/mcp-server"],
      "env": {
        "PROMZIA_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

**Restart Claude Desktop** after saving the config.

### Get Your API Key

1. Visit [promzia.ai/dashboard](https://promzia.ai/dashboard)
2. Sign up (free) or log in
3. Copy your API key from the dashboard
4. Paste it in the config above

**Without API key (Free Tier):**
- ✅ 10 searches per day
- ✅ 3 premium prompt unlocks per day
- ✅ Full access to free prompts

**With API key (Pro/Lifetime):**
- ✅ Unlimited searches
- ✅ Unlimited premium prompt access
- ✅ No daily limits

## Usage Examples

Once installed, here's how to use Promzia in Claude Desktop:

### 1. Search for Prompts

**You say:**
> "Find prompts related to cold email outreach"

**Claude uses:**
```
search_prompts({ query: "cold email outreach", category: "marketing" })
```

**You get:**
- List of matching prompts
- Tier indicators (🆓 Free / 💎 Premium)
- Brief descriptions

---

### 2. Get Prompt Details

**You say:**
> "Show me the 'cold-email-outreach' prompt"

**Claude uses:**
```
get_prompt({ prompt_id: "cold-email-outreach" })
```

**You get:**
- Full template text
- List of required variables
- Instructions and tips
- Example use cases

---

### 3. Fill Template Variables

**You say:**
> "Fill in the cold email template with:
> - Recipient: startup founders
> - Product: AI writing tool
> - Value: saves 5 hours/week"

**Claude uses:**
```
fill_prompt_template({
  prompt_id: "cold-email-outreach",
  variables: {
    "recipient_type": "startup founders",
    "product_name": "AI writing tool",
    "key_benefit": "saves 5 hours per week"
  }
})
```

**You get:**
- Complete, ready-to-use prompt
- All variables replaced with your values
- Ready to copy and use

---

### 4. Unlock Premium Prompts

**You say:**
> "Unlock the 'advanced-seo-strategy' prompt"

**Claude uses:**
```
unlock_premium_prompt({ prompt_id: "advanced-seo-strategy" })
```

**You get:**
- Full premium prompt content
- Remaining daily views (Free: 2/3 left)
- Or unlimited access (Pro/Lifetime)

---

### 5. Get Contextual Suggestions

**You say:**
> "I need to write a launch announcement for my new SaaS product"

**Claude uses:**
```
suggest_prompt({ context: "write launch announcement for SaaS product" })
```

**You get:**
- Relevant prompt suggestions
- Matched to your specific need
- Ranked by relevance

## Available Tools

### `search_prompts`

Find prompts by keyword, category, or type.

**Parameters:**
- `query` (string, optional) - Search keywords
- `category` (string, optional) - e.g., "marketing", "writing", "business"
- `type` (string, optional) - "text" or "image"
- `limit` (number, optional) - Max results (default: 10)

---

### `get_prompt`

Get full details including template and variables.

**Parameters:**
- `prompt_id` (string, required) - Prompt slug or ID

**Note:** Premium prompts show preview only for free users. Use `unlock_premium_prompt` to access.

---

### `unlock_premium_prompt`

Unlock a premium prompt (Free: uses 1 of 3 daily views. Pro: unlimited).

**Parameters:**
- `prompt_id` (string, required) - Prompt slug or ID

---

### `suggest_prompt`

Get context-aware recommendations.

**Parameters:**
- `context` (string, required) - What you're trying to accomplish
- `limit` (number, optional) - Max suggestions (default: 5)

---

### `fill_prompt_template`

Fill template variables and get ready-to-use prompt.

**Parameters:**
- `prompt_id` (string, required) - Prompt slug or ID
- `variables` (object, required) - Key-value pairs

**Example:**
```json
{
  "prompt_id": "blog-post-outline",
  "variables": {
    "topic": "AI in healthcare",
    "audience": "medical professionals",
    "tone": "professional and informative"
  }
}
```

## Categories

Explore prompts across these categories:

| Category | Use Cases |
|----------|-----------|
| **Marketing** | Email campaigns, ads, social media, SEO |
| **Writing** | Blog posts, articles, copywriting, editing |
| **Business** | Proposals, reports, presentations, strategy |
| **Education** | Lesson plans, teaching materials, courses |
| **Creative** | Stories, scripts, brainstorming, worldbuilding |
| **Technical** | Documentation, code explanations, debugging |
| **Finance** | Investment analysis, budgeting, financial planning |
| **Productivity** | Task management, planning, organization |

## Troubleshooting

### MCP Server Not Appearing

1. **Check config file location:**
   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`

2. **Verify JSON syntax:**
   - Use [JSONLint](https://jsonlint.com) to validate
   - No trailing commas
   - Quotes around all strings

3. **Restart Claude Desktop completely:**
   - Quit (not just close window)
   - Reopen

### "Authentication required" Errors

- Add `PROMZIA_API_KEY` to your config
- Get key from [promzia.ai/dashboard](https://promzia.ai/dashboard)
- Free tier includes 10 searches/day + 3 premium views/day

### Premium Prompts Locked

**Free users:** Use `unlock_premium_prompt` to unlock (3/day)  
**Pro users:** Should have automatic access — verify API key is correct

### Check Current Version

1. Open Claude Desktop MCP settings
2. Click **"View Logs"** on Promzia server
3. Look for: `[Promzia MCP Server v1.0.4] Starting...`

### Force Update to Latest Version

```bash
# Clear npx cache
npx clear-npx-cache

# Restart Claude Desktop
```

Claude will download the latest version on next start.

## Other MCP Clients

### Cursor

1. **Settings** → **Tools & Integrations** → **New MCP Server**
2. Configure:
   - Name: `Promzia`
   - Command: `npx -y @promzia/mcp-server`
   - Env: `PROMZIA_API_KEY=your_key_here`

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "promzia": {
      "command": "npx",
      "args": ["-y", "@promzia/mcp-server"],
      "env": {
        "PROMZIA_API_KEY": "your_key_here"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add promzia --env PROMZIA_API_KEY=your_key_here -- npx -y @promzia/mcp-server
```

### Cline (VS Code)

1. Open Cline's **MCP Marketplace**
2. Search "Promzia" and install

Or configure in Cline settings manually.

## Learn More

- **Full Documentation:** [promzia.ai/mcp](https://promzia.ai/mcp)
- **Get API Key:** [promzia.ai/dashboard](https://promzia.ai/dashboard)
- **Browse Prompts:** [promzia.ai/browse](https://promzia.ai/browse)
- **Upgrade to Pro:** [promzia.ai/pricing](https://promzia.ai/pricing)

## Support

- **Email:** support@promzia.ai
- **Issues:** [GitHub](https://github.com/promzia/mcp-server/issues)
- **Docs:** [promzia.ai/docs](https://promzia.ai/docs)

## License

MIT © Promzia