Sweeppea-Development-Lab/sweeppea-mcp-info

**Model Context Protocol for Sweepstakes Management**
---
How It Works
The Sweeppea MCP Server is a secure bridge between AI assistants and the Sweeppea API. It translates natural language interactions into structured API calls, giving your AI assistant full access to sweepstakes management — participants, official rules, winners, calendars, billing, and more.
No local setup required — just point your MCP client to the endpoint and authenticate.
---
Authentication & Pricing
This MCP server requires a **Sweeppea API Key** tied to an active subscription.
Running sweepstakes in the United States and/or Canada is legally complex. Each state has its own regulations — registration requirements, bonding thresholds, void-where-prohibited rules, prize disclosure laws, and official rules that must comply with federal and state-level consumer protection statutes. Getting any of this wrong exposes sponsors to real legal liability.
Sweeppea handles that complexity for you and much more. The platform generates legally compliant official rules, manages multi-state eligibility, enforces entry limits, and provides an auditable record of every participant and winner draw. The API Key you use to connect isn't just authentication — it's your access to a system built specifically to keep sweepstakes legally defensible.
**To get started:**
1. Create an account at www.sweeppea.com
2. Choose a plan that fits your needs
3. Get your API Key from the API dashboard
4. Connect your MCP client using the configuration guides below
**Documentation:**
- MCP Server docs: mcpdocs.sweeppea.com
- API documentation: apidocs.sweeppea.com
---
Server-side Validations
The server enforces business and legal rules **before** a tool executes. If a call violates a rule, the tool is rejected and never reaches the Sweeppea API — no resources are created.
Two layers run on every tools/call:
- **Hardcoded legal guardrails (inviolable):** illegal lottery without AMOE, COPPA (minimum age below 13), alcohol 21+ age gate, nicotine 21+ age gate and state exclusions, no nicotine products as prizes, and explicit confirmation for promotions aimed at minors.
- **Dynamic declarative rules (editable by Sweeppea):** additional checks on create_sweepstakes, update_entry_settings, create_rules_wizard, create_note, create_ticket, and add_participant.
A rejection returns a structured payload so your AI assistant can recover:
rule_id is only present for dynamic rules. The AI assistant can read these fields and adjust the arguments before retrying.
Irreversible tools — every delete_*, plus send_message, send_code, cancel_campaign, remove_suppression, unassign_code and remove_drip_contact — require confirm: true and are rejected without it.
---
Quick Start
Using **Claude Code CLI**:
See Platform Setup for Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini CLI, and more.
---
Available Tools (116)
Account Tools (4)
| Tool | Description |
|------|-------------|
| health_check | Verify connection to Sweeppea API and validate your API key |
| get_profile | Get user profile information for a Sweeppea account |
| get_business | Get business information including company details and address |
| get_plan | Get subscription plan details including pricing, limits and features |
Entry Page Tools (3)
| Tool | Description |
|------|-------------|
| get_entry_fields | Get all form fields for a sweepstakes entry page. Use before adding participants |
| get_entry_settings | Get all entry page settings: display, colors, compliance, confirmation, winners, age gate, AMOE, and more |
| update_entry_settings | Update 1-5 entry page settings per request. Supports 80+ configurable fields |
Sweepstakes Tools (7)
| Tool | Description |
|------|-------------|
| fetch_sweepstakes | List sweepstakes with pagination. Returns a summary with a computed lifecycle state (scheduled, running, ended) |
| create_sweepstakes | Create a new sweepstakes with type, handler, dates, and times |
| update_sweepstakes | Update an existing sweepstakes (name, dates, times) |
| clone_sweepstakes | Clone an existing sweepstakes with new parameters and dates |
| pause_sweepstakes | Pause a sweepstakes, setting it to inactive while preserving data |
| unpause_sweepstakes | Reactivate a paused sweepstakes to allow new entries |