Rafflex

npx add-mcp 'https://api.rafflex.xyz/mcp'

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.

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

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.