Sweeppea API

Powerful REST API for managing sweepstakes, participants, and promotional campaigns.

Base URL

https://api-v3.sweeppea.com

Authentication

All requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP Server

Sweeppea Renaissance includes a full Model Context Protocol (MCP) Server implementation, allowing you to integrate the entire platform with any LLM or AI-powered application.

Connect your AI assistants, chatbots, autonomous agents, or any device that communicates with an LLM to manage sweepstakes, participants, winners, and more — all through natural language.

With the MCP Server, your AI can access every Sweeppea tool programmatically, making it possible to operate the platform from any device or robot connected to a language model.

rocket_launchQuick Start

Get up and running with the MCP Server in minutes.

View Guide →
buildTools

Explore all available MCP tools and their capabilities.

View Tools →
codeExamples

Real-world usage examples and integration patterns.

View Examples →
devicesPlatforms

Supported platforms and compatibility information.

View Platforms →
sync_altProtocol

Technical details about the MCP protocol specification.

View Protocol →
starShowcase

See what others are building with the Sweeppea MCP Server.

View Showcase →

Command Line Interface (CLI)

The official Sweeppea CLI puts the same API in your terminal. It is a single native binary (written in Rust) distributed on npm — no runtime to install, instant startup.

Use it interactively or in CI: every command supports --json for machine-readable output, and destructive actions confirm first and honor --yes.

npx @sweeppea/cli auth login
downloadInstall

Prebuilt binaries for Linux, macOS and Windows via npm.

View Install →
vpn_keyAuthentication

Your API key, validated and stored in the OS keyring.

View Auth →
terminalCommands

13 resource categories — full parity with the MCP Server.

View Commands →

The Sweeppea Developer Ecosystem

Three clients, one platform, one API key. All of them talk to this same REST API v3 — pick whichever fits how you work.

apiREST API v3

Direct HTTP integration, with a full OpenAPI 3.1 specification.

apidocs.sweeppea.com · you are here
smart_toyMCP Server

71 tools for AI assistants — Claude, Cursor, Windsurf, Gemini CLI and more.

mcpdocs.sweeppea.com ↗
terminalCLI

A native binary for your shell and CI — npx @sweeppea/cli, JSON output everywhere.

clidocs.sweeppea.com ↗