@promzia/mcp-server
v1.0.5
Published
Access 3000+ curated AI prompts directly in Claude, Cursor, Windsurf, and any MCP-compatible client
Maintainers
Readme
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
{
"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
- Visit promzia.ai/dashboard
- Sign up (free) or log in
- Copy your API key from the dashboard
- 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 keywordscategory(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 accomplishlimit(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 IDvariables(object, required) - Key-value pairs
Example:
{
"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
Check config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
Verify JSON syntax:
- Use JSONLint to validate
- No trailing commas
- Quotes around all strings
Restart Claude Desktop completely:
- Quit (not just close window)
- Reopen
"Authentication required" Errors
- Add
PROMZIA_API_KEYto your config - Get key from 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
- Open Claude Desktop MCP settings
- Click "View Logs" on Promzia server
- Look for:
[Promzia MCP Server v1.0.4] Starting...
Force Update to Latest Version
# Clear npx cache
npx clear-npx-cache
# Restart Claude DesktopClaude will download the latest version on next start.
Other MCP Clients
Cursor
- Settings → Tools & Integrations → New MCP Server
- Configure:
- Name:
Promzia - Command:
npx -y @promzia/mcp-server - Env:
PROMZIA_API_KEY=your_key_here
- Name:
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"promzia": {
"command": "npx",
"args": ["-y", "@promzia/mcp-server"],
"env": {
"PROMZIA_API_KEY": "your_key_here"
}
}
}
}Claude Code
claude mcp add promzia --env PROMZIA_API_KEY=your_key_here -- npx -y @promzia/mcp-serverCline (VS Code)
- Open Cline's MCP Marketplace
- Search "Promzia" and install
Or configure in Cline settings manually.
Learn More
- Full Documentation: promzia.ai/mcp
- Get API Key: promzia.ai/dashboard
- Browse Prompts: promzia.ai/browse
- Upgrade to Pro: promzia.ai/pricing
Support
- Email: [email protected]
- Issues: GitHub
- Docs: promzia.ai/docs
License
MIT © Promzia
