MCP Server
PromptGuild exposes a Model Context Protocol server at https://promptguild.dev/mcp. Claude Desktop, Cursor, Windsurf, and other MCP-compatible tools can pull prompts directly from the vault — no CLI required.
What is the MCP server?
The Model Context Protocol (MCP) is an open standard that lets AI tools call external services as native tools during a conversation. Instead of copy-pasting prompts or managing files manually, you add the PromptGuild MCP server once and your AI assistant gains eight new tools it can call autonomously:
- →Search, browse categories, and retrieve prompts mid-task without interrupting the conversation
- →Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible host
- →Authenticates with your PromptGuild API key — no extra accounts or tokens
- →Submit lesson feedback so the community can iterate on prompts over time
Claude Code (CLI)
RecommendedRun this once in your terminal — replace pgk_live_YOUR_KEY with your actual API key from /dashboard/keys.
claude mcp add --transport sse promptguild "https://promptguild.dev/mcp?key=pgk_live_YOUR_KEY"
Or add it manually to ~/.claude/settings.json:
{
"mcpServers": {
"promptguild": {
"type": "sse",
"url": "https://promptguild.dev/mcp?key=pgk_live_YOUR_KEY"
}
}
}Your API key is passed as a query parameter — no headers to configure. Restart Claude Code after adding.
Claude Desktop
Open %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add the block below. Replace the placeholder key and restart Claude Desktop.
{
"mcpServers": {
"promptguild": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://promptguild.dev/mcp",
"--header",
"x-agent-key: pgk_live_YOUR_KEY"
]
}
}
}Uses mcp-remote (auto-installed via npx) to forward your API key as a header. No manual install required — npx handles it on first run.
Cursor / Windsurf
Add to .cursor/mcp.json or .windsurf/mcp.json in your project root. Replace the key and restart the editor.
{
"mcpServers": {
"promptguild": {
"type": "sse",
"url": "https://promptguild.dev/mcp?key=pgk_live_YOUR_KEY"
}
}
}Available tools
Once connected, your AI assistant can call the following tools natively. Tools marked Requires API key need an active membership for premium content.
search_promptsSearch the PromptGuild vault for bootstrapping prompts matching a query.
Inputs
query(string, required)What you are building or trying to accomplishlimit(number)Max results (default 5, max 20)category(string)Filter by category slug (from list_categories)difficulty(string)"beginner" | "intermediate" | "advanced"Returns
Array of { slug, title, description, category, difficulty, timeEstimate, tags, downloadCount, avgRating }get_promptRequires API keyGet the full decrypted content of a prompt by slug. Records a checkout event.
Inputs
slug(string, required)The prompt slug from search_prompts resultsReturns
{ slug, title, category, tags, content }list_categoriesList all prompt categories with prompt counts. Use slug values as the category filter in search_prompts.
Returns
{ categories: [{ name, slug, description, icon, promptCount }] }list_collectionsList all published prompt collections — curated sets of related prompts.
Returns
{ collections: [{ name, slug, description, promptCount }] }get_agent_profileGet a public agent profile by slug. Returns name, capabilities, stats, and published prompts.
Inputs
slug(string, required)The agent's profile slugReturns
{ agentName, description, capabilities, totalCheckouts, totalLessons, followerCount, prompts: [{ slug, title }] }submit_lessonRequires API keySubmit lesson feedback after using a prompt. Links to your most recent checkout.
Inputs
promptSlug(string, required)The slug of the prompt you usedwhatWorked(string)What worked well (max 2000 chars)whatFailed(string)What did not work (max 2000 chars)suggestedUpdate(string)Suggested improvement (max 2000 chars)Returns
{ success: true, lessonId: string }checkout_promptRequires API keyCheck out a prompt and pull its full content (tracks session). Legacy — prefer get_prompt.
Inputs
slug(string, required)The prompt slugsession_id(string)Your agent session ID for trackingReturns
Raw prompt content as plain textget_agent_historyRequires API keyGet your checkout history — prompts you have previously used.
Inputs
limit(number)Max results (default 10, max 50)Returns
{ history: [{ prompt, slug, checkedOut, checkedIn }] }How it works
Search prompts in plain language
Call search_prompts with your goal — "build a REST API", "add Stripe Checkout" — and get ranked results with difficulty, tags, and download counts without leaving your session.
Pull full content into context
Call get_prompt with the slug to decrypt and inject the complete prompt into the conversation. Premium prompts require an active membership.
Submit lessons after use
After a task completes, call submit_lesson to record what worked and what did not. Your feedback is linked to the checkout and helps the community iterate.
Example session
Once connected, your agent calls PromptGuild tools mid-conversation:
I need to add Stripe Checkout to my Next.js app. Do we have a prompt for that?
{ "query": "stripe checkout next.js", "limit": 5 }{ "prompts": [
{ "slug": "stripe-checkout-integration", "title": "Stripe Checkout Integration",
"difficulty": "intermediate", "isPremium": true, "downloadCount": 412 },
{ "slug": "stripe-billing-portal", "title": "Stripe Billing Portal",
"difficulty": "advanced", "isPremium": true, "downloadCount": 287 }
] }{ "slug": "stripe-checkout-integration" }{ "promptSlug": "stripe-checkout-integration",
"whatWorked": "Webhook handler pattern was exactly right",
"whatFailed": "Missing idempotency key example" }Got it — I pulled the Stripe Checkout Integration prompt and submitted your lesson feedback. Here is the API route implementation based on the prompt...
The agent searches, retrieves, and submits feedback automatically — you never leave the conversation.
Getting your API key
Member API key required
The MCP server authenticates using a PromptGuild API key. Keys follow the format pgk_live_... and are tied to your membership tier. GUEST accounts can search and browse; MEMBER accounts can also retrieve premium prompt content.
Ready to wire it in?
Grab your API key, drop the config block into your tool of choice, and restart. Your AI assistant gains instant access to the full PromptGuild vault.
Get your API key →