# Sweeppea MCP Server

> Sweeppea MCP Server is a Model Context Protocol (MCP) server for AI-powered sweepstakes management. It provides 53+ tools across 13 categories to manage sweepstakes, participants, official rules, winners, billing, calendar events, support tickets, and more — all accessible through any MCP-compatible AI client via Streamable HTTP transport.

The MCP server endpoint is https://mcp.sweeppea.com/ using MCP Protocol version 2025-11-25 with Bearer token authentication and JSON-RPC 2.0 format.

## Documentation

- [MCP Server Documentation](https://mcpdocs.sweeppea.com/): Complete setup guides, tool reference, usage examples, and platform configurations for Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, GitHub Copilot, Agent Zero, and Antigravity.
- [Tool Showcase](https://mcpdocs.sweeppea.com/showcase.html): Visual reference of all 53+ tools organized by category with parameters and descriptions.
- [Full LLM Documentation](https://mcpdocs.sweeppea.com/llms-full.txt): Extended AI-readable documentation with complete tool specifications, parameters, and usage details.

## Key Features

- 53+ MCP tools across 13 categories
- Streamable HTTP transport (MCP Protocol 2025-11-25)
- Works with Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, GitHub Copilot, Agent Zero, and Antigravity
- Sweepstakes lifecycle management (create, clone, pause, update, delete)
- Participant management with custom entry fields
- Official rules generation via 14-step wizard
- Winner drawing (instant and scheduled) with weighted random selection
- Group-based participant segmentation
- Calendar events, encrypted notes, and billing management
- Support ticket system with priority levels
- US utilities (states, zip codes, area codes, countries, timezones)
- AES-256-CBC encryption for sensitive data (notes)

## Tool Categories

- Account Tools (4): health_check, get_profile, get_business, get_plan
- Sweepstakes Tools (7): fetch_sweepstakes, create_sweepstakes, update_sweepstakes, clone_sweepstakes, pause_sweepstakes, unpause_sweepstakes, delete_sweepstakes
- Participant Tools (5): add_participant, get_participant, fetch_participants, count_participants, delete_participant
- Entry Page Tools (1): get_entry_fields
- Group Tools (4): fetch_groups, create_group, update_group, delete_group
- Notes Tools (4): fetch_notes, create_note, update_note, delete_note
- Calendar Tools (5): fetch_calendar_events, get_calendar_event, create_calendar_event, update_calendar_event, delete_calendar_event
- Rules Tools (5): fetch_rules, create_rule, update_rule, delete_rule, create_rules_wizard
- Billing & Wallet Tools (4): fetch_wallet_transactions, fetch_billing_transactions, fetch_billing_consumptions, fetch_data_transfer
- Support Tickets Tools (7): fetch_open_tickets, fetch_closed_tickets, get_ticket, create_ticket, resolve_ticket, update_ticket, delete_ticket
- Winner Tools (5): draw_winners, fetch_winners, schedule_drawing, fetch_scheduled_drawings, delete_scheduled_drawing
- Documentation Tools (1): fetch_documentation
- Utilities Tools (5): fetch_timezones, fetch_states, fetch_zipcodes, fetch_areacodes, fetch_countries
- Testing Tools (1): hello_world

## Quick Start

Add the server using Claude Code CLI:
```
claude mcp add sweeppea https://mcp.sweeppea.com/ --transport http --header "Authorization: Bearer YOUR_API_KEY" --header "MCP-Protocol-Version: 2025-11-25"
```

## API

- Endpoint: https://mcp.sweeppea.com/
- Protocol: MCP 2025-11-25 (Streamable HTTP)
- Auth: Bearer token (Sweeppea API key)
- Format: JSON-RPC 2.0

## Supported Platforms

- Claude Code (CLI)
- Claude Desktop / Cowork
- Cursor
- Windsurf
- GitHub Copilot (VS Code)
- Gemini CLI
- Agent Zero
- Antigravity by Google

## About Sweeppea

Sweeppea is a full-service and self-service sweepstakes platform. The MCP Server extends the platform with AI-powered management capabilities, allowing users to manage their sweepstakes campaigns entirely through natural language via AI assistants.