@promptingbox/mcp

MCP (Model Context Protocol) server for PromptingBox — save, manage, and organize prompts directly from Claude, Cursor, ChatGPT, and other MCP-compatible AI tools.

Setup

1. Get your API key

Go to PromptingBox Settings → MCP Integration and create an API key.

2. Install the server (run once)

npm install -g @promptingbox/mcp

3. Configure your AI tool

Tip: Name the server pbox so you can naturally say things like "save this to pbox" or "list my pbox prompts".

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "pbox": {
      "command": "promptingbox-mcp",
      "env": {
        "PROMPTINGBOX_API_KEY": "pb_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project (or global config):

{
  "mcpServers": {
    "pbox": {
      "command": "promptingbox-mcp",
      "env": {
        "PROMPTINGBOX_API_KEY": "pb_your_key_here"
      }
    }
  }
}

Claude Code

Add to .claude/mcp.json in your project:

{
  "mcpServers": {
    "pbox": {
      "command": "promptingbox-mcp",
      "env": {
        "PROMPTINGBOX_API_KEY": "pb_your_key_here"
      }
    }
  }
}

4. Restart your AI tool

Restart Claude Desktop or Cursor for the MCP server to be detected.

Usage

Once configured, you can say things like:

Saving & retrieving prompts:

• "Save this prompt to pbox"
• "Save this as 'Code Review Checklist' in my Work folder on pbox"
• "Get my prompt called 'Code Review'"
• "Search my pbox prompts for API"
• "List my pbox prompts"

Editing & managing prompts:

• "Update the content of 'Code Review'"
• "Delete the prompt called 'Old Draft'"
• "Duplicate 'Code Review'"
• "Star my 'Code Review' prompt"

Folders & tags:

• "Create a folder called 'Work'"
• "Move 'Code Review' to my Work folder"
• "Delete my 'Old' folder"
• "Tag 'Code Review' with testing and automation"
• "List my pbox folders"
• "List my pbox tags"

Version history:

• "Show version history for 'Code Review'"
• "Restore version 2 of 'Code Review'"

Templates:

• "Search pbox templates for email"
• "Save that template to my collection"

Account:

• "Which pbox account am I using?"

Available Tools

Prompt Management

Tool	Description
save_prompt	Save a prompt with title, content, optional folder and tags
get_prompt	Get the full content and metadata of a prompt
search_prompts	Search prompts by title, content, tag, folder, or favorites
update_prompt	Update a prompt's title and/or content (auto-versions)
delete_prompt	Permanently delete a prompt and all its versions
duplicate_prompt	Create a copy of an existing prompt
toggle_favorite	Star or unstar a prompt
list_prompts	List all prompts grouped by folder

Folder Management

Tool	Description
list_folders	List all folders in your account
create_folder	Create a new folder (or return existing one)
delete_folder	Delete a folder (prompts move to root, not deleted)
move_prompt_to_folder	Move a prompt to a different folder

Tag Management

Tool	Description
list_tags	List all tags in your account
add_tags	Set tags on a prompt (replaces existing, auto-creates new tags)
delete_tag	Delete a tag from your account and all prompts

Version History

Tool	Description
list_versions	View all saved versions of a prompt
restore_version	Restore a prompt to a previous version

Templates

Tool	Description
search_templates	Browse and search the public template library
use_template	Save a public template to your collection

Account

Tool	Description
whoami	Show which PromptingBox account is connected

Environment Variables

Variable	Required	Description
PROMPTINGBOX_API_KEY	Yes	Your PromptingBox API key (starts with pb_)
PROMPTINGBOX_BASE_URL	No	Override the API base URL (default: https://www.promptingbox.com)

License

MIT