Official MCP server for sweepstakes management. 71 tools across 16 categories for legally compliant sweepstakes in the US and Canada.
Official MCP server for sweepstakes management. 71 tools across 16 categories for legally compliant sweepstakes in the US and Canada.
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.
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| 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 |
| 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 |
| 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 |
| delete_sweepstakes | Permanently delete a sweepstakes and all associated data |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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, priority, assignee and platform |
| 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 |
| 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 |
| 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 |
| fetch_files | List all files in the user's Drive with storage usage, categories, and pagination |
| upload_file | Upload a file to the user's Drive. The file must be base64-encoded |
| get_file_url | Generate a short-lived presigned S3 URL to download or preview a file from the user's Drive |
| send_file | Send a file from the user's Drive as an email attachment |
| delete_file | Permanently delete a file from the user's Drive |
| create_invoice | Create an invoice. Subtotal, tax and total are computed server-side ($1–$1,000,000, max 60 line items) |
| fetch_invoices | List invoices with pagination and filters by status and date range |
| get_invoice | Get full invoice detail: line items, payment info, public link, QR code, stats and event timeline |
| update_invoice | Update an invoice. State machine draft → pending → paid; paid and cancelled are immutable |
| delete_invoice | Permanently delete an invoice. Cannot be undone — use status cancelled to keep it as history |
| create_survey | Create a survey attached to a sweepstakes, optionally with its full question set |
| fetch_surveys | List surveys with pagination, filtered by sweepstakes, enabled state or archived state |
| get_survey | Get full survey detail including its complete question set, sorted by page then order |
| update_survey | Update a survey. The question set is a full replacement and locks once responses exist |
| delete_survey | Permanently delete a survey, its questions, responses, stats and files. Cannot be undone |
| fetch_survey_responses | Get individual responses with each answer. Device/IP metadata is PII and off by default |
| fetch_survey_report | Get the aggregated report: totals, completion rate, device breakdown, timeline, distributions |
| fetch_code_stats | Count the codes of a sweepstakes by status |
| fetch_codes | List codes with the participant each one is assigned to. Server-side filters, search and sorting |
| get_code | Get one code by token, or by the code itself plus the sweepstakes token (point of sale) |
| create_codes | Import 1–1,000 codes you already have. Reports Created, Duplicates and Invalid separately |
| generate_codes | Generate up to 5,000 random codes with optional prefix, suffix, value and expiration |
| update_code | Partially update one code. null clears a field; the code itself can only be renamed while unassigned |
| delete_codes | Permanently delete up to 1,000 codes. Assigned, redeemed and voided codes are skipped. Requires confirm: true |
| assign_code | Assign an available code to a participant of the same sweepstakes. Does not notify anyone |
| unassign_code | Take a code back from a participant, clearing its redemption too. Requires confirm: true |
| redeem_code | Redeem a code by token, or by the code itself at the point of sale. Reversible |
| unredeem_code | Undo a redemption while keeping the assignment |
| get_code_settings | Get how the entry and AMOE pages hand out codes |
| update_code_settings | Configure code registration modes, generation and delivery for entry and AMOE pages |
| send_code | Send a code to the participant holding it by email and/or SMS. Cannot be recalled. Requires confirm: true |
| fetch_messaging_usage | Get messaging access, plan channels, allowance, sending pauses and 10DLC status |
| fetch_campaigns | List campaigns with filters by sweepstakes, channel, category, status and name |
| get_campaign | Get campaign content, audience, sender profile, counters and the actions its status allows |
| fetch_campaign_report | Get the campaign report. Rates are computed over messages sent, not over the audience |
| fetch_campaign_recipients | List recipients with delivery status, filtered by status or one exact address |
| pause_campaign | Pause a queued or sending campaign. Messages already handed to the carrier still go out |
| resume_campaign | Resume a paused campaign after re-checking everything that would stop it again |
| cancel_campaign | Cancel a campaign permanently. Cannot be resumed. Requires confirm: true |
| fetch_suppressions | List suppressed addresses: unsubscribes, STOP replies, complaints, bounces and manual entries |
| add_suppressions | Suppress up to 500 email addresses or phone numbers. Never downgrades an existing opt-out |
| remove_suppression | Remove a manually added suppression. Opt-outs, STOP replies and complaints are never removable. Requires confirm: true |
| send_message | Send a plain-text message by email and/or SMS to a participant of your account. Cannot be recalled. Requires confirm: true |
| fetch_documentation | Get help and support documentation articles with pagination and search |
| fetch_timezones | Get all available timezones with IANA identifiers and UTC offsets |
| fetch_states | Get all US states including DC, Puerto Rico, and territories |
| fetch_zipcodes | Search US zip codes by code, city, or state. Up to 10 results |
| fetch_areacodes | Search US telephone area codes by code or state. Up to 10 results |
| fetch_countries | Search countries by name, dial code, or ISO abbreviation. Up to 10 results |
| hello_world | Simple test tool to verify MCP connection is working properly |
{
"mcpServers": {
"sweeppea": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.sweeppea.com/",
"--header",
"Authorization: Bearer YOUR_API_KEY",
"--header",
"MCP-Protocol-Version: 2025-11-25"
]
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
Access Stripe billing and payment tools through its MCP server. Connect with OAuth or a supported agent API key and choose the intended account.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.
Build for Shopify with current APIs — the official Dev MCP server for schema-accurate storefront and admin code.
Give your AI assistant a supervised window into your Interactive Brokers account — balances, positions, live quotes and orders.
Invoices, payments and disputes through PayPal's official server — commerce operations by conversation.