# community-prompt-voting-mcp-server

**MCP server for community-driven prompt voting and discovery** — submit, upvote, and find the best AI prompts. Like Reddit/HackerNews, but for prompts.

[![PyPI version](https://badge.fury.io/py/community-prompt-voting-mcp-server.svg)](https://pypi.org/project/community-prompt-voting-mcp-server/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Why Community Prompt Voting?

The best prompts should rise to the top. This MCP server brings democratic voting to AI prompt libraries:

- **Community-driven**: Anyone can submit prompts, anyone can vote
- **Network effect**: More users → better prompts → more users (exponential value)
- **Trending**: Like HackerNews — recent + upvoted prompts surface first
- **Searchable**: Find prompts by keyword, category, or tags

## Tools (7)

| Tool | Description |
|------|-------------|
| `submit_prompt` | Submit a new prompt to the community library |
| `upvote_prompt` | Upvote a prompt (toggle to remove vote) |
| `downvote_prompt` | Downvote a prompt (toggle to remove vote) |
| `get_trending_prompts` | Get trending prompts (score × recency) |
| `get_category_rankings` | Rankings by category |
| `search_prompts` | Search by keyword, category, or tags |
| `get_voting_info` | System statistics and top-rated prompts |

## Installation

```bash
pip install community-prompt-voting-mcp-server
```

## Claude Desktop Configuration

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "community-prompt-voting": {
      "command": "community-prompt-voting-mcp-server"
    }
  }
}
```

## Usage Examples

```
# Discover trending prompts
get_trending_prompts(limit=10)

# Submit a prompt
submit_prompt(
    title="Chain-of-Thought Debugger",
    prompt_text="Walk through this code step by step...",
    category="coding",
    tags="debugging,cot,code"
)

# Vote on a prompt
upvote_prompt(prompt_id="p001", voter_id="my_agent_id")

# Find writing prompts
search_prompts(category="writing", sort_by="score")

# See all categories
get_category_rankings()
```

## Categories

`reasoning` · `coding` · `writing` · `data` · `education` · `creative` · `research` · `productivity` · `roleplay` · `other`

## Data Storage

Prompts and votes are stored locally at `~/.community_prompt_voting_store.json`. The server ships with 5 seed prompts to bootstrap the community experience.

## Network Effect

> "The best prompts rise through community voting. Every new voter makes the library better for everyone."

This server is part of the [AiAgentKarl](https://github.com/AiAgentKarl) MCP ecosystem — 55+ servers for AI agent infrastructure.

## License

MIT