Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CACHE_TTL | No | Cache time-to-live (5 minutes) | 300000 |
| GITHUB_PATH | No | Path within repo (optional) | |
| GITHUB_REPO | Yes | Repository name | prompts |
| GITHUB_OWNER | Yes | GitHub username or organization | jezweb |
| GITHUB_TOKEN | No | Personal access token (for private repos) | |
| GITHUB_BRANCH | No | Branch to fetch from | main |
| ENABLE_USAGE_TRACKING | No | Enable usage tracking | true |
| CACHE_REFRESH_INTERVAL | No | Refresh interval (1 minute) | 60000 |
| ENABLE_SEMANTIC_SEARCH | No | Enable semantic search | true |
| ENABLE_PROMPT_COMPOSITION | No | Enable prompt composition | true |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| compose_prompt | Compose multiple prompts together |
| search_prompts | Search for prompts by keyword |
| suggest_prompts | Get AI-powered prompt suggestions |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| All Prompts | List all available prompts |
| Prompt Categories | List all prompt categories |
| Prompt Tags | List all prompt tags |
| Usage Statistics | Get prompt usage statistics |
| Recent Prompts | Get recently used prompts |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| prompts_help | Get help understanding how to use the Smart Prompts tools effectively. Returns guidance on tool usage, examples, and best practices. |
| search_prompts | 🔍 ALWAYS START HERE: Search for prompts by keyword, category, or tags. Returns matching prompts with their metadata. This is the recommended first step before using get_prompt or creating new prompts. Helps avoid duplicates and find exactly what you need. |
| list_prompt_categories | 📋 Overview: List all available prompt categories with prompt counts. Use this to explore the library structure and see what categories exist before searching or creating prompts. Great for discovering new areas. |
| get_prompt | 📖 Get Full Prompt: Retrieve a specific prompt by its exact name. ⚠️ IMPORTANT: Use search_prompts first to find the correct prompt name, then use this tool. Returns the complete prompt content with metadata and template variables. |
| create_github_prompt | ✨ Create New Prompt: Create a new prompt and save it directly to the GitHub repository. 🎯 WORKFLOW: Always use search_prompts first to check if a similar prompt already exists. Only create new prompts when needed to avoid duplicates. |
| compose_prompts | 🔗 Combine Prompts: Combine multiple existing prompts into a single prompt. Perfect for creating complex multi-step workflows. 📋 WORKFLOW: Use search_prompts to find prompt names first, then compose them. |
| check_github_status | Check GitHub connection status and write access. Use this to verify GitHub operations are available. |