browse_prompts

Browse your personal Promptsy library directly in the conversation.

Overview

The browse_prompts tool displays your prompts in an interactive widget, allowing you to view, copy, and navigate your vault without leaving the AI conversation.

Requires Authentication

Parameters

Parameter	Type	Required	Default	Description
limit	number	No	20	Number of prompts to return (1-50)
offset	number	No	0	Pagination offset for fetching more results

Usage Examples

Basic Usage

"Show me my prompts"

Claude/ChatGPT will call the tool and display your prompt library.

With Pagination

"Show me more prompts" "Show the next 20 prompts"

The tool will increment the offset to fetch the next page.

Programmatic Call

{
  "tool": "browse_prompts",
  "parameters": {
    "limit": 10,
    "offset": 0
  }
}

Response

The tool returns both text content and structured data:

Text Response

A formatted summary of your prompts for the conversation.

Structured Content

{
  prompts: Prompt[],      // Array of your prompts
  total: number,          // Total prompt count
  hasMore: boolean,       // More results available
  offset: number,         // Current offset
  limit: number,          // Items per page
  canUseVariableSets: boolean  // Solo+ feature
}

Prompt Object

interface Prompt {
  id: string;
  title: string;
  description: string | null;
  body: string;
  category: string | null;
  models: string[];
  use_cases: string[];
  tags: { id: string; name: string }[];
  collection: {
    id: string;
    name: string;
    color: string;
  } | null;
  is_shared: boolean;
  star_count: number;
  copy_count: number;
  last_used_at: string | null;
  created_at: string;
  updated_at: string;
}

Widget Features

The interactive widget displays:

Tabs

• All - All your prompts
• Recent - Sorted by last used
• Starred - Your starred prompts

Prompt Cards

Each card shows:

• Title and description preview
• Category badge
• Collection indicator with color
• Variable count (if any {{variables}} present)

Actions

• Copy - Copy prompt to clipboard
• Expand - View full prompt body
• Edit - Open prompt in Promptsy web app

Metadata

The response includes credits information:

{
  "_meta": {
    "credits_remaining": 47
  }
}

Errors

Error Code	Description	Solution
AUTH_REQUIRED	Not authenticated	Authorize the integration
TOKEN_EXPIRED	Access token expired	Token will auto-refresh
INSUFFICIENT_SCOPE	Missing prompts:read scope	Re-authorize with correct scopes

Tips

Filtering by Collection

The tool returns all prompts, but you can ask the AI to filter:

"Show my prompts in the 'Work' collection"

Finding Specific Prompts

For more targeted searches, ask:

"Find my prompt about email templates"

The AI can filter the results based on title, description, and content.

Copying with Variables

For prompts with {{variables}}:

"Copy the code review prompt and fill in the variable for Python"

The AI can help substitute variables before copying.

Related Tools

• save_prompt - Save new prompts
• get_prompt - View full content of a prompt
• search_public_prompts - Search community prompts
• fork_prompt - Fork public prompts to your vault