sweepstakesmarketingpromotionscomplianceparticipants
Remote MCP server for managing sweepstakes, participants, rules, entries, winners, and billing through the Sweeppea API.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Create and update sweepstakes
Manage participants and bonus entries
Configure entry page and compliance settings
Generate and manage official rules
Draw and administer winners
Key features
83 MCP tools for Sweeppea management
Participant search, pagination, filtering, and counts
Sweepstakes creation, cloning, pausing, and deletion
Entry page settings with compliance and age-gate controls
Server-side legal and business-rule validation
Streamable HTTP transport
Capabilities & Tool Schemas (80)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Sweeppea MCP Info.
health_checkVerify connection to Sweeppea API and validate your API key
get_profileGet user profile information for a Sweeppea account
get_businessGet business information including company details and address
get_planGet subscription plan details including pricing, limits and features
get_entry_fieldsGet all form fields for a sweepstakes entry page. Use before adding participants
get_entry_settingsGet all entry page settings: display, colors, compliance, confirmation, winners, age gate, AMOE, and more
Documentation Overview
Sweeppea MCP Server
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:
- Create an account at www.sweeppea.com
- Choose a plan that fits your needs
- Get your API Key from the API dashboard
- 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), and alcohol age gate.
- Dynamic declarative rules (editable by Sweeppea): additional checks on
create_sweepstakes,update_entry_settings,create_rules_wizard,create_note,create_ticket, andadd_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.
Quick Start
Using Claude Code CLI:
See Platform Setup for Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini CLI, and more.
Available Tools (83)
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 | Get all sweepstakes associated with your account |
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 |
delete_sweepstakes | Permanently delete a sweepstakes and all associated data |
Participant Tools (6)
| Tool | Description |
|---|---|
add_participant | Add a new participant to a sweepstakes with custom fields. Both email and phone are required |
get_participant | Fetch a single participant by token, email, or phone number |
fetch_participants | List participants with pagination (20/page), search, and date filters |
count_participants | Get participant counts with optional filtering by type and date |
update_bonus_entries | Update the bonus entries value for a participant in a sweepstakes |
delete_participant | Permanently remove a participant from a sweepstakes |
Group Tools (4)
| Tool | Description |
|---|---|
fetch_groups | Get all groups from a sweepstakes for participant segmentation |
create_group | Create a new group within a sweepstakes |
update_group | Update the name of an existing group in a sweepstakes |
delete_group | Delete a group. Cannot delete primary, locked, or groups with participants |
Notes Tools (5)
| Tool | Description |
|---|---|
fetch_notes | Get all notes, decrypted and in reverse chronological order |
get_note | Fetch a single note by token. Content is automatically decrypted |
create_note | Create a new note. Content is encrypted using AES-256-CBC |
update_note | Update an existing note. Supports partial updates |
delete_note | Permanently delete a note. This action cannot be undone |
Calendar Tools (5)
| Tool | Description |
|---|---|
fetch_calendar_events | Get all calendar events with dates, times, and status |
get_calendar_event | Get a single calendar event by its token with full details |
create_calendar_event | Create a new calendar event with title, dates, and notifications |
update_calendar_event | Update an existing calendar event. Cannot update to past dates |
delete_calendar_event | Permanently delete a calendar event. Cannot be undone |
Rules Tools (5)
| Tool | Description |
|---|---|
fetch_rules | Get all official rules including primary and secondary rules |
create_rule | Create a new official rules document with HTML content |
update_rule | Update an existing official rules document. Supports partial updates |
delete_rule | Permanently delete an official rules document. Cannot be undone |
create_rules_wizard | Generate official rules via 14-step wizard. Complete HTML rules server-side |
Billing & Wallet Tools (4)
| Tool | Description |
|---|---|
fetch_wallet_transactions | Get all wallet transactions including credits, debits, and payments |
fetch_billing_transactions | Get all billing transactions including invoices and amounts |
fetch_billing_consumptions | Get monthly and yearly billing consumption totals |
fetch_data_transfer | Get data transfer records for a specific sweepstakes with costs |
Support Tickets Tools (7)
| Tool | Description |
|---|---|
fetch_open_tickets | Get open tickets with pagination, search, platform and priority filters |
fetch_closed_tickets | Get closed tickets with pagination, search, platform and priority filters |
get_ticket | Get full ticket details by case number including notes and files |
create_ticket | Create a new support ticket with title, description, and priority |
resolve_ticket | Close/resolve an open support ticket |
update_ticket | Update an open support ticket. At least one field required |
delete_ticket | Permanently delete an open support ticket. Cannot be undone |
Winners Tools (5)
| Tool | Description |
|---|---|
fetch_winners | Get winners from a sweepstakes with pagination and search |
draw_winners | Draw random winners from eligible participants |
schedule_drawing | Schedule a future winner drawing for a sweepstakes |
fetch_scheduled_drawings | Get all scheduled drawings for a sweepstakes |
delete_scheduled_drawing | Delete a pending scheduled drawing. Only pending drawings can be deleted |
To-Do Tools (4)
| Tool | Description |
|---|---|
fetch_todos | Get all To-Do items with pagination (20 per page), search, and advanced filters |
create_todo | Create a new internal To-Do item |
update_todo | Update an existing To-Do item. Supports partial updates |
delete_todo | Permanently delete a To-Do item. This action cannot be undone |
Files Tools (5)
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
2
Stargazers on the source repository.
Last commit
1mo ago
Most recent push to the default branch.
Tools exposed
80
Callable tools this server registers over MCP.
Directory activity
1 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Sweeppea MCP Info
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/sweeppea-development-lab-sweeppea-mcp-info)HTML Embed
<a href="https://allmcps.com/mcp/sweeppea-development-lab-sweeppea-mcp-info"><img src="https://allmcps.com/api/badge/sweeppea-development-lab-sweeppea-mcp-info?style=directory" alt="Sweeppea MCP Info on AllMCPs" /></a>