# Rafflys — MCP server on mcp.ai
> Connect your Rafflys account and use 2 tools for social media marketing straight from your AI agent. Connect with your own API key. Rafflys hosts giveaways and contests, enabling brands to engage audiences, grow social reach, and reward participants with automated selection processes.

By: mcp.ai · official
Page: https://mcp.ai/rafflys

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_rafflys?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/rafflys/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/rafflys/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/rafflys/skill.md
Postman collection (v2.1): https://mcp.ai/rafflys/postman.json

## Tools
- rafflys_get_current_user() — Tool to retrieve details of the authenticated user. Use when confirming your current account information.
- rafflys_list_promotions(page?: integer, per_page?: integer) — Tool to list all promotions. Use when you need to retrieve available promotions for display or reporting.

## Example prompts
- "What can I do in Rafflys?"
- "Show me a summary of my Rafflys account"

## Links
Docs: https://mcp.ai/docs/mcps/rafflys
Website: https://mcp.ai/mcps/rafflys