使用说明
Sweeppea MCP Server — Documentation
Version: 1.23.1 | Tools: 116 | Categories: 21 | Protocol: MCP 2025-11-25
Sweeppea MCP Server is a Model Context Protocol (MCP) server for AI-powered sweepstakes management. It provides 116 tools across 21 categories to manage sweepstakes, participants, official rules, winners, billing, calendar events, support tickets, and more — all accessible through any MCP-compatible AI client via Streamable HTTP transport.
Availability: This MCP server is available exclusively for Sweeppea clients in the United States and Canada.
Quick Start
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"
Connection Details
| Property | Value |
|---|---|
| Endpoint | https://mcp.sweeppea.com/ |
| Protocol | MCP 2025-11-25 (Streamable HTTP) |
| Auth | Bearer token (Sweeppea API key) |
| Format | JSON-RPC 2.0 |
Tool Categories
| # | Category | Tools | Description |
|---|---|---|---|
| 1 | Account | 4 | Profile, business info, plan details, health check |
| 2 | Sweepstakes | 7 | Create, update, clone, pause, delete sweepstakes |
| 3 | Participants | 6 | Add, search, list, count, delete participants |
| 4 | Entry Page | 3 | Form fields, settings, configuration |
| 5 | Groups | 4 | Participant segmentation and organization |
| 6 | Notes | 5 | Encrypted notes management |
| 7 | Calendar | 5 | Campaign milestone calendar events |
| 8 | Rules | 5 | Official rules documents and wizard |
| 9 | Billing & Wallet | 4 | Usage, wallet and billing transactions, data transfer |
| 10 | Support Tickets | 7 | Create and manage support requests |
| 11 | Winners | 5 | Draw winners, schedule drawings |
| 12 | Documentation | 1 | Search help articles |
| 13 | Utilities | 5 | States, ZIP codes, area codes, countries, timezones |
| 14 | To-Do | 4 | Internal task management (admin only) |
| 15 | Testing | 1 | Connection verification |
| 16 | Files | 5 | Upload, list, delete, share files, and generate short-lived URLs |
| 17 | Invoices | 5 | Create, list, update, cancel and delete invoices (account-gated module) |
| 18 | Surveys | 7 | Surveys attached to sweepstakes: questions, responses, reports (account-gated module) |
| 19 | Codes & Coupons | 14 | Import or generate codes, assign, redeem, settings and delivery (account-gated module) |
| 20 | Messaging | 12 | Campaigns, delivery reports, suppression list and direct messages (account-gated module) |
| 21 | Drip Campaigns | 7 | Automated email/SMS sequences: read, report, enrollments, pause, resume, remove a contact (account-gated module) |
Platform Setup
See Platform Setup Guide for configuration instructions for:
- Claude Code (CLI)
- Claude Desktop / Cowork
- Cursor
- Windsurf
- GitHub Copilot (VS Code)
- Gemini CLI
- Agent Zero
- Antigravity by Google
Legal & Compliance
See Legal Compliance Guide for:
- Mandatory checklist for a legally compliant sweepstakes
- AMOE requirements
- State registration and bonding rules
- Industry-specific restrictions (alcohol, cannabis)
AI Agent Operational Guide
See AI Agent Guide for:
- Step-by-step workflow for AI agents
- Critical guardrails and prohibited promotions
- Automatic compliance decisions
- Tool chaining best practices
Useful Links
- MCP Docs (Web): https://mcpdocs.sweeppea.com/
- MCP Endpoint: https://mcp.sweeppea.com/
- Sweeppea Platform: https://www.sweeppea.com
- Tool Showcase: https://mcpdocs.sweeppea.com/showcase.html
The Sweeppea Developer Ecosystem
Three clients, one platform, one API key — all of them talk to the Sweeppea REST API v3.
| For | Docs | |
|---|---|---|
| MCP Server | AI assistants (Claude, Cursor, Windsurf, Gemini CLI…) | https://mcpdocs.sweeppea.com/ |
| CLI | Your shell and CI — npx @sweeppea/cli |
https://clidocs.sweeppea.com/ |
| REST API v3 | Direct HTTP integration (OpenAPI spec included) | https://apidocs.sweeppea.com/ |
