What is the Sweeppea MCP Server?

Sweeppea MCP Server is a Model Context Protocol (MCP) server for AI-powered sweepstakes management. It provides 53+ tools across 13 categories to manage sweepstakes, participants, official rules, winners, billing, calendar events, support tickets, and more — all accessible through any MCP-compatible AI client.

Which AI platforms are supported?

Sweeppea MCP Server works with Claude Code, Claude Desktop, Cowork, Cursor, Windsurf, GitHub Copilot (VS Code), Gemini CLI, Agent Zero, and Antigravity by Google. Any MCP-compatible client using Streamable HTTP transport is supported.

How do I connect to the Sweeppea MCP Server?

For Claude Code CLI, run: claude mcp add sweeppea https://mcp.sweeppea.com/ --transport http --header 'Authorization: Bearer YOUR_API_KEY' --header 'MCP-Protocol-Version: 2025-11-25'. For other platforms, add the JSON configuration to the respective config file. See the Platform Setup section for specific instructions.

What tools are available in the Sweeppea MCP Server?

The server provides 53+ tools across 13 categories: Account (4), Sweepstakes (7), Participants (5), Entry Page (1), Groups (4), Notes (4), Calendar (5), Rules (5), Billing & Wallet (4), Support Tickets (7), Winners (5), Documentation (1), Utilities (5), and Testing (1).

What protocol does the Sweeppea MCP Server use?

The server uses MCP Protocol version 2025-11-25 with Streamable HTTP transport, Bearer token authentication, and JSON-RPC 2.0 format. The endpoint is https://mcp.sweeppea.com/.

Sweeppea MCP Server | AI-Powered Sweepstakes Management via Model Context Protocol

Name: Sweeppea MCP Server
Author: Sweeppea

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

$ MCP Server v1.10.2

Model Context Protocol for Sweepstakes Management

# Quick Start

terminal

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

Using Claude Code CLI. See Platform Setup for Claude Desktop/Cowork and other clients.

# Available Tools (53)

Account Tools

4 ▾

Account

health_check

Verify connection to Sweeppea API and validate your API key.

no params

Account

get_profile

Get user profile information for a Sweeppea account.

no params

Account

get_business

Get business information including company details and address.

no params

Account

get_plan

Get subscription plan details including pricing, limits and features.

no params

Entry Page Tools

1 ▾

Entry Page

get_entry_fields

Get all form fields for a sweepstakes entry page. Use before adding participants.

sweepstakes_token

Sweepstakes Tools

7 ▾

Sweepstakes

fetch_sweepstakes

Get all sweepstakes associated with your account.

no params

Sweepstakes

create_sweepstakes

Create a new sweepstakes with type, handler, dates, and times.

sweepstakes_name sweepstakes_type handler start_date end_date start_time end_time create_in_calendar sync_with_winners

Sweepstakes

update_sweepstakes

Update an existing sweepstakes (name, dates, times).

sweepstakes_token sweepstakes_name start_date end_date start_time end_time

Sweepstakes

clone_sweepstakes

Clone an existing sweepstakes with new parameters and dates.

handler handler_new sweepstakes_name start_date end_date start_time end_time

Sweepstakes

pause_sweepstakes

Pause a sweepstakes, setting it to inactive while preserving data.

sweepstakes_token

Sweepstakes

unpause_sweepstakes

Reactivate a paused sweepstakes to allow new entries.

sweepstakes_token

Sweepstakes

delete_sweepstakes

Permanently delete a sweepstakes and all associated data.

sweepstakes_token

Participant Tools

5 ▾

Participants

add_participant

Add a new participant to a sweepstakes with custom fields.

sweepstakes_token email fields phone bonus_entries

Participants

get_participant

Fetch a single participant by token, email, or phone number.

sweepstakes_token participant_token email phone

Participants

fetch_participants

List participants with pagination (20/page), search, and date filters.

sweepstakes_token search opt_in_date start_date end_date page

Participants

count_participants

Get participant counts with optional filtering by type and date.

sweepstakes_token filter_type start_date end_date

Participants

delete_participant

Permanently remove a participant from a sweepstakes.

sweepstakes_token participant_token

Group Tools

4 ▾

Groups

fetch_groups

Get all groups from a sweepstakes for participant segmentation.

sweepstakes_token

Groups

create_group

Create a new group within a sweepstakes.

sweepstakes_token group_name

Groups

update_group

Update the name of an existing group in a sweepstakes.

sweepstakes_token group_token group_name

Groups

delete_group

Delete a group. Cannot delete primary, locked, or groups with participants.

sweepstakes_token group_token

Notes Tools

4 ▾

Notes

fetch_notes

Get all notes, decrypted and in reverse chronological order.

no params

Notes

create_note

Create a new note. Content is encrypted using AES-256-CBC.

title content pinned

Notes

update_note

Update an existing note. Supports partial updates.

note_token title content pinned

Notes

delete_note

Permanently delete a note. This action cannot be undone.

note_token

Calendar Tools

5 ▾

Calendar

fetch_calendar_events

Get all calendar events with dates, times, and status.

no params

Calendar

get_calendar_event

Get a single calendar event by its token with full details.

event_token

Calendar

create_calendar_event

Create a new calendar event with title, dates, and notifications.

title start_date end_date description location start_time end_time

Calendar

update_calendar_event

Update an existing calendar event. Cannot update to past dates.

event_token title start_date end_date

Calendar

delete_calendar_event

Permanently delete a calendar event. Cannot be undone.

event_token

Rules Tools

5 ▾

Rules

fetch_rules

Get all official rules including primary and secondary rules.

sweepstakes_token

Rules

create_rule

Create a new official rules document with HTML content.

sweepstakes_token title document_content

Rules

update_rule

Update an existing official rules document. Supports partial updates.

sweepstakes_token rules_token title document_content

Rules

delete_rule

Permanently delete an official rules document. Cannot be undone.

sweepstakes_token rules_token

Rules

create_rules_wizard

Generate official rules via 14-step wizard. Complete HTML rules server-side.

sweepstakes_token arv sweepstakes_name prize_description sponsor_name method_of_entry +19 more required +15 conditional

Billing & Wallet Tools

4 ▾

Billing

fetch_wallet_transactions

Get all wallet transactions including credits, debits, and payments.

no params

Billing

fetch_billing_transactions

Get all billing transactions including invoices and amounts.

no params

Billing

fetch_billing_consumptions

Get monthly and yearly billing consumption totals.

no params

Billing

fetch_data_transfer

Get data transfer records for a specific sweepstakes with costs.

sweepstakes_token

Support Tickets Tools

7 ▾

Support

fetch_open_tickets

Get open tickets with pagination, search, platform and priority filters.

search platform priority page

Support

fetch_closed_tickets

Get closed tickets with pagination, search, platform and priority filters.

search platform priority page

Support

get_ticket

Get full ticket details by case number including notes and files.

case_number

Support

create_ticket

Create a new support ticket with title, description, and priority.

title description priority

Support

resolve_ticket

Close/resolve an open support ticket.

case_id

Support

update_ticket

Update an open support ticket. At least one field required.

case_id title description

Support

delete_ticket

Permanently delete an open support ticket. Cannot be undone.

case_id

Documentation Tools

1 ▾

Documentation

fetch_documentation

Get help and support documentation articles with pagination and search.

page limit search

Utilities Tools

5 ▾

Utilities

fetch_timezones

Get all available timezones with IANA identifiers and UTC offsets.

no params

Utilities

fetch_states

Get all US states including DC, Puerto Rico, and territories.

no params

Utilities

fetch_zipcodes

Search US zip codes by code, city, or state. Up to 10 results.

Utilities

fetch_areacodes

Search US telephone area codes by code or state. Up to 10 results.

Utilities

fetch_countries

Search countries by name, dial code, or ISO abbreviation. Up to 10 results.

Testing Tools

1 ▾

Testing

hello_world

Simple test tool to verify MCP connection is working properly.

name

# Usage Examples

initialize

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

Add server with a single command

terminal

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

Add to claude_desktop_config.json (requires Node.js installed)

Config file location:

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

claude_desktop_config.json

{
  "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)

Step-by-step:

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

mcp.json

{
  "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)

Step-by-step:

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

mcp_config.json

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

mcp.json

{
  "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)

settings.json

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

Step-by-step:

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

Note: On first connection, Agent Zero will automatically install the required libraries to connect to the MCP server.

MCP Server Config

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

Troubleshooting: Common connection issues

Error: SSEError: Expected Content-Type 'text/event-stream', got 'application/json'

This happens when "type" is set to "sse" instead of "streamable-http". Sweeppea uses MCP Protocol 2025-11-25 with Streamable HTTP transport, not SSE.

Error: UI "Apply" button is disabled (greyed out)

Known bug in Agent Zero v0.9.7-10. The UI rejects valid JSON configurations. Workaround: edit the config file directly and restart.

Manual fix (when UI is broken)

# 1. Backup
cp /a0/tmp/settings.json /a0/tmp/settings_backup.json

# 2. Edit with Python (mcp_servers is a JSON string inside JSON)
python3 -c "
import json
with open('/a0/tmp/settings.json', 'r') as f:
    config = json.load(f)
mcp = json.loads(config['mcp_servers'])
mcp['mcpServers']['sweeppea']['type'] = 'streamable-http'
mcp['mcpServers']['sweeppea']['headers']['MCP-Protocol-Version'] = '2025-11-25'
config['mcp_servers'] = json.dumps(mcp)
with open('/a0/tmp/settings.json', 'w') as f:
    json.dump(config, f, indent=2)
print('Done')
"

# 3. Restart Agent Zero
docker restart agent-zero

Important: In settings.json, the field mcp_servers is a JSON string (not an object). You must parse it, modify it, stringify it back, then save.

> Antigravity by Google

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

mcp_config.json

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

version 2025-11-25

transport streamable-http

auth bearer token

format json-rpc 2.0

Sweeppea MCP Server — AI-Powered Sweepstakes Management

# Quick Start

# Available Tools (53)

Account Tools

Entry Page Tools

Sweepstakes Tools

Participant Tools

Group Tools

Notes Tools

Calendar Tools

Rules Tools

Billing & Wallet Tools

Support Tickets Tools

Documentation Tools

Utilities Tools

Testing Tools

# Usage Examples

# Platform Setup

> Claude Code (CLI)

> Claude Desktop / Cowork

> Cursor

> Windsurf

> GitHub Copilot (VS Code)

> Gemini CLI

> Agent Zero

> Antigravity by Google

# Protocol