What can you do with this server?

The Sweeppea MCP Server bridges AI assistants with the Sweeppea API via 70+ tools, enabling legally compliant sweepstakes management in the US and Canada. * Account Management – Verify connections, retrieve user profile, business info, and subscription plan details * Sweepstakes Lifecycle – Create, update, clone, pause, unpause, and delete sweepstakes campaigns * Entry Page Configuration – View and update 80+ entry page settings (display, colors, compliance, age gate, AMOE, etc.) * Participant Management – Add, fetch, list, count, update bonus entries, and delete participants * Group Segmentation – Create and manage participant groups within a sweepstakes * Winner Management – Draw random winners, schedule future drawings, and manage scheduled drawing records * Official Rules – Generate legally compliant rules via a 14-step wizard, or create/update/delete rules documents manually * Calendar Events – Create and manage sweepstakes-related calendar events with notifications * Notes – Create and manage AES-256-CBC encrypted notes * Billing & Wallet – View wallet transactions, invoices, consumption totals, and data transfer costs * Support Tickets – Create, update, resolve, and delete tickets with priority and platform filters * To-Do Items – Create and manage internal to-do tasks * File Management – Upload (base64), send as email attachments, fetch, and delete files from Drive storage * Documentation – Search and retrieve help/support articles * Utilities – Look up timezones, US states, zip codes, area codes, and countries * Testing – Verify MCP connection with a hello-world tool

de en es ja ko ru zh

Sweeppea MCP

by Sweeppea-Development-Lab

Overview Schema Related Servers Score Discussions

JavaScript

Remote

 ___
/ __|_ __ _____ ___ _ __ _ __  ___ __ _
\__ \ V  V / -_) -_) '_ \ '_ \/ -_) _` |
|___/\_/\_/\___\___| .__/ .__/\___\__,_|
                   |_|  |_|

Sweeppea MCP Server

Model Context Protocol for Sweepstakes Management

MCP Protocol Server Version Tools Transport License

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.

Your AI Assistant  →  MCP (Model Context Protocol)  →  Sweeppea MCP Server  →  Sweeppea API v3

No local setup required — just point your MCP client to the endpoint and authenticate.

Related MCP server: Marketing Brain

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, and add_participant.

A rejection returns a structured payload so your AI assistant can recover:

{
  "blocked_by": "server_validation",
  "error_code": "ALCOHOL_AGE_GATE_REQUIRED",
  "error_message": "Alcohol-related sweepstakes require an age gate of 21+.",
  "rule_id": "age_gate_must_be_21_when_active_v1"
}

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:

claude mcp add sweeppea https://mcp.sweeppea.com/ \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "MCP-Protocol-Version: 2025-11-25"

See Platform Setup for Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini CLI, and more.

Available Tools (71)

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
`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)

Tool	Description
`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

Documentation Tools (1)

Tool	Description
`fetch_documentation`	Get help and support documentation articles with pagination and search

Utilities Tools (5)

Tool	Description
`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

Testing Tools (1)

Tool	Description
`hello_world`	Simple test tool to verify MCP connection is working properly

Usage Examples

Initialize connection:

curl -X POST https://mcp.sweeppea.com/ \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "clientInfo": {"name": "client"}
    }
  }'

Add a participant:

curl -X POST https://mcp.sweeppea.com/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "MCP-Session-Id: uuid-xxx" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "add_participant",
      "arguments": {
        "sweepstakes_token": "xxx-xxx-xxx",
        "email": "user@example.com",
        "fields": {"First_Name": "John", "Last_Name": "Doe"}
      }
    }
  }'

Platform Setup

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"

Claude Desktop / Cowork

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Requires Node.js installed.

{
  "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"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project)

Create or edit the config file with the JSON below
Replace YOUR_API_KEY with your Sweeppea API Key
Restart Cursor
Go to Settings > Tools & MCP
Enable the sweeppea server with the toggle switch

{
  "mcpServers": {
    "sweeppea": {
      "url": "https://mcp.sweeppea.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json (global)

Create or edit the config file with the JSON below
Replace YOUR_API_KEY with your Sweeppea API Key
Go to Settings > Cascade > MCP Servers
Verify that sweeppea appears and is enabled

{
  "mcpServers": {
    "sweeppea": {
      "serverUrl": "https://mcp.sweeppea.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

GitHub Copilot (VS Code)

.vscode/mcp.json (workspace) or User Settings

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sweeppea-api-key",
      "description": "Sweeppea API Key",
      "password": true
    }
  ],
  "servers": {
    "sweeppea": {
      "type": "http",
      "url": "https://mcp.sweeppea.com/",
      "headers": {
        "Authorization": "Bearer ${input:sweeppea-api-key}",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

Gemini CLI

~/.gemini/settings.json (global) or .gemini/settings.json (project)

{
  "mcpServers": {
    "sweeppea": {
      "httpUrl": "https://mcp.sweeppea.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

Agent Zero

Open-source AI agent framework with MCP support.

Go to Settings > MCP/A2A > MCP Servers
Add the JSON configuration below
Replace YOUR_API_KEY with your Sweeppea API Key
Click Save

{
  "mcpServers": {
    "sweeppea": {
      "description": "Sweeppea - Sweepstakes Management API",
      "type": "streamable-http",
      "url": "https://mcp.sweeppea.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

Antigravity by Google

~/.gemini/antigravity/mcp_config.json (global)

{
  "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"
      ]
    }
  }
}

Protocol

Property	Value
Version	`2025-11-25`
Transport	Streamable HTTP
Authentication	Bearer token
Format	JSON-RPC 2.0
Endpoint	`https://mcp.sweeppea.com/`

License

MIT License - see LICENSE file for details.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2wRelease cycle

2Releases (12mo)

Resources

GitHub Repository

Need Help?

Related Servers

Tools

sweeppea_connectA

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sweeppea-Development-Lab/sweeppea-mcp-info'

If you have feedback or need assistance with the MCP directory API, please join our Discord server