# Rafflys — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_rafflys?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `rafflys_get_current_user`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/rafflys`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/rafflys/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/rafflys/get/current/user` — Tool to retrieve details of the authenticated user. Use when confirming your current account information.
- `POST https://api.mcp.ai/api/rafflys/list/promotions` — Tool to list all promotions. Use when you need to retrieve available promotions for display or reporting.
  - body: { page?: integer, per_page?: integer }

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

## More
- Page: https://mcp.ai/rafflys
- Agent spec (llms.txt): https://mcp.ai/rafflys/llms.txt
- Postman collection: https://mcp.ai/rafflys/postman.json