Sweeppea MCP

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

Sweeppea MCP服务器

抽奖管理的模型上下文协议

______________________________________________________________________

运作原理

Sweeppea MCP服务器是AI助手和 API豌豆.它将自然语言交互转换为结构化的API调用，使您的人工智能助手能够完全访问抽奖管理-参与者、官方规则、获胜者、日历、账单等。

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

无需本地设置，只需将MCP客户端指向端点并进行身份验证。

______________________________________________________________________

身份验证和定价

此MCP服务器需要 豌豆API密钥 绑定到活动订阅。

在美国和/或加拿大举办抽奖活动在法律上很复杂。每个州都有自己的规定——注册要求、保证金门槛、禁止无效的规则、奖金披露法以及必须符合联邦和州消费者保护法规的官方规则。任何一个错误都会使赞助商承担真正的法律责任。

Sweeppea为您处理这种复杂性以及更多。该平台制定符合法律的官方规则，管理多州资格，执行入境限制，并提供每个参与者和获胜者抽奖的可审计记录。您用于连接的API密钥不仅仅是身份验证，它还包括您对专门为保持彩票合法辩护而构建的系统的访问。

开始：

1. 在以下网址创建帐户 www.sweeppea.com
2. 选择一个符合您需求的计划
3. 从API仪表板获取API密钥
4. 使用连接您的MCP客户端 下面的配置指南

文档：

• MCP服务器文档： mcpdocs.sweeppea.com
• API文件： apidocs.sweepea.com

______________________________________________________________________

服务器端验证

服务器执行业务和法律规则 之前 工具执行。如果调用违反了规则，该工具将被拒绝，并且永远不会到达Sweeppea API-不会创建任何资源。

每层都有两层 tools/call:

• 硬编码的法律护栏（不可侵犯）： 没有AMOE、COPPA（最低年龄低于13岁）和酒精年龄限制的非法彩票。
• 动态声明性规则（可由Sweeppea编辑）： 额外检查 create_sweepstakes, update_entry_settings, create_rules_wizard, create_note, create_ticket，以及 add_participant.

拒绝会返回一个结构化的有效负载，以便您的AI助手可以恢复：

{
  "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 仅适用于动态规则。AI助手可以在重试之前读取这些字段并调整参数。

______________________________________________________________________

快速开始

使用 Claude 代码命令行工具:

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、Cursor、Windsurf、GitHub Copilot、Gemini CLI等。

______________________________________________________________________

可用工具（71）

账户工具（4）

入口页面工具（3）

抽奖工具（7）

参与者工具（6）

组工具（4）

笔记工具（5）

日历工具（5）

规则工具（5）

账单和钱包工具（4）

支持票工具（7）

获奖者工具（5）

待办事项工具（4）

文件工具（5）

文档工具（1）

实用工具（5）

测试工具（1）

______________________________________________________________________

使用示例

初始化连接：

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

______________________________________________________________________

平台设置

克劳德代码（CLI）

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
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

需要安装Node.js。

{
  "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 （全球）或 .cursor/mcp.json （项目）

1. 使用下面的JSON创建或编辑配置文件
2. 替换 YOUR_API_KEY 使用您的Sweeppea API密钥
3. 重新启动游标
4. 首选 设置>工具和MCP
5. 启用 瑞典 带切换开关的服务器

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

帆板运动

~/.codeium/windsurf/mcp_config.json （全球）

1. 使用下面的JSON创建或编辑配置文件
2. 替换 YOUR_API_KEY 使用您的Sweeppea API密钥
3. 首选 设置>级联>MCP服务器
4. 核实一下 瑞典 出现并启用

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

GitHub副本（VS代码）

.vscode/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 （全球）或 .gemini/settings.json （项目）

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

零号特工

支持MCP的开源AI代理框架。

1. 首选 设置>MCP/A2A>MCP服务器
2. 在下面添加JSON配置
3. 替换 YOUR_API_KEY 使用您的Sweeppea API密钥
4. 点击 保存

{
  "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 （全球）

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

______________________________________________________________________

协议

______________________________________________________________________

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

（c） Sweeppea |版权所有