search_public_prompts

Search the Promptsy community library for prompts shared by other users.

Overview

The search_public_prompts tool provides access to thousands of community prompts. Use it to discover new prompts, find inspiration, or fork prompts to your own vault.

No Authentication Required

Parameters

Parameter	Type	Required	Default	Description
query	string	No	-	Search query (max 200 chars)
category	string	No	-	Filter by category
sort	string	No	See below	Sort order
limit	number	No	20	Results per page (1-50)
offset	number	No	0	Pagination offset

Sort Options

Value	Description	Default When
relevance	Best match to query	Query provided
trending	Recent + popular	No query
recent	Newest first	-
popular	Most copies/stars	-

Categories

• general
• writing
• coding
• analysis
• creative
• business
• education
• productivity
• communication
• other

Usage Examples

Basic Search

"Find public prompts about writing emails"

{
  "tool": "search_public_prompts",
  "parameters": {
    "query": "writing emails"
  }
}

Category Filter

"Show me trending coding prompts"

{
  "tool": "search_public_prompts",
  "parameters": {
    "category": "coding",
    "sort": "trending"
  }
}

Combined Search

"Find popular prompts for data analysis"

{
  "tool": "search_public_prompts",
  "parameters": {
    "query": "data analysis",
    "sort": "popular",
    "limit": 10
  }
}

Response

Structured Content

{
  prompts: PublicPrompt[],
  total: number,
  hasMore: boolean,
  offset: number,
  limit: number,
  query?: string,
  category?: string,
  sort: string,
  searchMode: "hybrid" | "fts"
}

PublicPrompt Object

interface PublicPrompt {
  id: string;
  title: string;
  description: string | null;
  body: string;
  shareSlug: string;           // URL-safe identifier
  author: {
    id: string;
    username: string;
    displayName: string | null;
  };
  stats: {
    copyCount: number;
    forkCount: number;
    starCount: number;
  };
  tags: { id: string; name: string }[];
  category: string | null;
  useCases: string[];
  models: string[];
  createdAt: string;
  highlights?: {               // Present when searching
    title: string | null;
    description: string | null;
    body: string | null;
  };
}

Search Highlights

When you search, matching text is highlighted:

{
  "highlights": {
    "title": "Email <mark>Writing</mark> Assistant",
    "description": "Helps you <mark>write</mark> professional <mark>emails</mark>",
    "body": null
  }
}

Widget Features

The results are displayed in an interactive widget:

Prompt Cards

Each card shows:

• Title and description
• Author username
• Stats (copies, forks, stars)
• Category badge
• Tag chips

Actions

• View - Expand to see full prompt
• Copy - Copy prompt to clipboard
• Fork - Save to your vault (requires auth)
• Star - Star the prompt (requires auth)

Search Behavior

Hybrid Search

When a query is provided, the tool uses hybrid semantic search:

1. Semantic matching - Understands meaning, not just keywords
2. Full-text search - Matches exact terms
3. Ranking - Combines relevance signals

Without Query

Returns prompts sorted by the specified order (default: trending).

Trending Algorithm

The "trending" sort considers:

• Recent activity (last 7 days)
• Copy count
• Star count
• Fork count

Tips

Effective Searching

Be specific about what you need:

"Find prompts for debugging Python async code"

Is better than:

"Find coding prompts"

Discovering by Category

Browse categories to find inspiration:

"Show me the most popular creative writing prompts" "What are trending productivity prompts?"

Forking to Your Vault

When you find a useful prompt, use its id (UUID) to fork it:

"Fork the email template prompt to my vault"

User: "Find prompts for code review"
AI: [calls search_public_prompts] → Shows results with IDs

User: "Fork the first one"
AI: [calls fork_prompt with the prompt's id] → Saves to vault

The id field in each search result is the UUID you need for the fork_prompt tool. This creates a copy you can customize.

Non-ChatGPT Only

The fork_prompt tool is available in Claude Desktop, Cursor, Windsurf, and other MCP clients. ChatGPT users can fork prompts directly from the widget interface.

Rate Limits

Public search has rate limits:

• 30 requests/minute per IP
• No authentication required

Errors

Error Code	Description	Solution
RATE_LIMITED	Too many requests	Wait and try again
VALIDATION_ERROR	Invalid parameters	Check parameter formats

Related Tools

• browse_prompts - Browse your own prompts
• save_prompt - Save prompts to your vault
• fork_prompt - Fork public prompts to your vault
• get_prompt - View full content of your prompts