Sweeppea MCP
About
Manage sweepstakes, participants, and winner drawings with legal compliance in the US and Canada directly from your AI agent. Access requires an active Sweeppea subscription and API Key.
Details
- Author
- sweeppea-development-lab
- Categories
- Other, Developer Tools
Jump to
Setup
Install Sweeppea MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/sweeppea-development-lab/sweeppea-mcp-info
Follow the installation instructions in the repository README, then restart your MCP client.
___ / __|_ __ _____ ___ _ __ _ __ ___ __ _ \__ \ V V / -_) -_) '_ \ '_ \/ -_) _ | |___/\_/\_/\___\___| .__/ .__/\___\__,_| |_| |_|
Model Context Protocol for Sweepstakes Management
The Sweeppea MCP Server is a secure bridge between AI assistants and theSweeppea 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.
This MCP server requires aSweeppea API Keytied 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.
- Create an account atwww.sweeppea.com
- Choose a plan that fits your needs
- Get your API Key from the API dashboard
- Connect your MCP client using theconfiguration guides below
- MCP Server docs:mcpdocs.sweeppea.com
- API documentation:apidocs.sweeppea.com
The server enforces business and legal rulesbeforea tool executes. If a call violates a rule, the tool is rejected and never reaches the Sweeppea API — no resources are created.
- 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 oncreate_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:
{ "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_idis only present for dynamic rules. The AI assistant can read these fields and adjust the arguments before retrying.
claude mcp add sweeppea https://mcp.sweeppea.com/ \ --transport http \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "MCP-Protocol-Version: 2025-11-25"
SeePlatform Setupfor Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini CLI, and more.
Requires theInvoices moduleenabled on the account — disabled by default. The API returns403 "module is not enabled"until Sweeppea activates it; contact support to request access.
Requires theSurveys moduleenabled on the account — disabled by default. The API returns403 "module is not enabled"until Sweeppea activates it; contact support to request access.
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"} } }'
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"} } } }'
claude mcp add sweeppea https://mcp.sweeppea.com/ \ --transport http \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "MCP-Protocol-Version: 2025-11-25"
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
{ "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/mcp.json(global) or.cursor/mcp.json(project)YOUR_API_KEY
- Create or edit the config file with the JSON below
- Replacewith your Sweeppea API Key
- Restart Cursor
- Go toSettings > Tools & MCP
- Enable thesweeppeaserver with the toggle switch
{ "mcpServers": { "sweeppea": { "url": "https://mcp.sweeppea.com/", "headers": { "Authorization": "Bearer YOUR_API_KEY", "MCP-Protocol-Version": "2025-11-25" } } } }
~/.codeium/windsurf/mcp_config.json(global)YOUR_API_KEY
- Create or edit the config file with the JSON below
- Replacewith your Sweeppea API Key
- Go toSettings > Cascade > MCP Servers
- Verify thatsweeppeaappears and is enabled
{ "mcpServers": { "sweeppea": { "serverUrl": "https://mcp.sweeppea.com/", "headers": { "Authorization": "Bearer YOUR_API_KEY", "MCP-Protocol-Version": "2025-11-25" } } } }
.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/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" } } } }
Open-source AI agent framework with MCP support.
- Go toSettings > MCP/A2A > MCP Servers
- Add the JSON configuration below
- ReplaceYOUR_API_KEYwith your Sweeppea API Key
- ClickSave
{ "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" } } } }
~/.gemini/antigravity/mcp_config.json(global)
MIT License - seeLICENSEfile for details.
Chia Health MCP Server — Patient workflow integration for a licensed US telehealth platform. Browse GLP-1 medications (semaglutide, tirzepatide), peptide therapies (sermorelin, NAD+, glutathione), and longevity treatments. Check eligibility, complete intake, sign consents, and manage treatment plans. 30 tools, HIPAA-compliant. All prescriptions evaluated by licensed US healthcare providers and delivered from FDA-regulated pharmacies across 50 states + DC.
Broker + MCP server for last-bidder-wins games on Solana — agents register, auto-fund a Privy wallet, and bid via streamable HTTP
AI-powered no-code app builder with 17 MCP tools — create projects, generate pages from natural language, AI text/image generation (GPT, Claude, Gemini, 14+ models), page CRUD, workflow execution, publish & version control. SSE transport, API key auth.
An mcp server for your food ordering needs.
Agent-to-Agent handoff certification for multi-agent systems — validates context preservation, verifies agent capabilities before handoff, logs transfer chains, and ensures no data loss in agent orchestration.
Unified MCP & skill management gateway with progressive disclosure. Manages multiple MCP servers as Agent Apps, loading tool schemas on demand for 99% context token savings. Shared across Claude Code, Codex, OpenCode and more.
A collection of Model Context Protocol (MCP) servers for various tasks and integrations, supporting both Python and Node.js environments.
Open-souSecurely feeds real security refreshed rules into Cursor, Claude Code, and Windsurf — zero config, no API key.
Health intelligence MCP — access biomarkers, biological age, and personalized longevity action plans from your Aniva profile.
Real-time stock heatmaps and investment tools delivered as interactive React components.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
