DOCS · MCP

Connect your
AI assistant

Rafflex runs a remote MCP server so ChatGPT, Claude, Cursor and other clients can draft and manage raffles for your projects — with your approval before anything is published.

In-app setup guide How it works

Connect

Server URL: https://api.rafflex.xyz/mcp (Streamable HTTP, OAuth). Requires an active Pro plan on the project owner’s account.

ChatGPT

Add a custom remote MCP connector with the URL above and sign in with your Rafflex account when prompted. Workspace settings may restrict custom connectors or write actions.

Claude

Add a custom connector with the URL above and complete the OAuth sign-in.

Cursor

{
  "mcpServers": {
    "rafflex": { "url": "https://api.rafflex.xyz/mcp" }
  }
}

Permissions and approval

You approve rafflex:read and/or rafflex:write when connecting. Every operation re-checks your project role, the project’s status and the owner’s Pro eligibility. Publishing needs a preview of the exact raffle version (valid for 30 minutes) and your explicit approval — connection consent alone never publishes a raffle.

Tools

Tool	What it does
`discover_projects`	Projects you can manage and whether they are eligible
`search_reward_projects`	Find a reward project for a collab
`create_reward_project`	Add a reward project to the catalog
`list_raffle_templates / get_raffle_template`	Reuse saved raffle setups
`normalize_x_requirements`	Turn post links and handles into valid X requirements
`prepare_draft_from_brief / create_draft_from_brief`	Turn a plain-language brief into a draft
`create_draft / update_draft`	Create or edit a draft with explicit settings
`get_discord_configuration / resolve_discord_entities`	Pick Discord channels and roles
`list_raffles / read_raffle`	Look up existing raffles
`preview_raffle`	Produce the reviewable preview of an exact raffle version
`commit_reviews`	Publish after your explicit approval

MCP questions

What is the Rafflex MCP server URL?

https://api.rafflex.xyz/mcp — a Streamable HTTP MCP server with OAuth (authorization code + PKCE) and dynamic client registration.

Do I need an API key for MCP?

No. MCP uses OAuth: sign in with your Rafflex account and approve read and/or write access. Never put a project API key in an MCP configuration.

How do I disconnect an assistant?

Remove the connector in your assistant; clients should also revoke their tokens. Access tokens last 15 minutes and refresh tokens 30 days.

REST API

Manage projects, raffles, templates, entries and winners with project API keys.

AI raffles via MCP

Draft and publish raffles from ChatGPT, Claude or any MCP-compatible assistant.

YOUR NEXT DROP

Run it on Rafflex

Random draw or FCFS, verified entry actions, and a winner list that gets where it needs to go. Try every Pro feature free for 7 days — no card required.

Launch your first raffle Browse live raffles