@wheelfor/mcp

MCP server for wheelfor.com — create, spin, and manage shareable decision wheels from any MCP-compatible AI client.

Works with Claude Desktop, Cursor, Windsurf, VS Code, and any other MCP host. No account required.

Tools

Tool	Description
create_wheel	Create a new spinning wheel from a list of options
spin_wheel	Spin an existing wheel and get a random result with a shareable URL
update_wheel	Update a wheel's choices, name, or theme using its edit key
decide	Pick randomly from a list and create a permanent wheel in one step

Installation

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "wheelfor": {
      "command": "npx",
      "args": ["-y", "@wheelfor/mcp"]
    }
  }
}

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "wheelfor": {
      "command": "npx",
      "args": ["-y", "@wheelfor/mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "wheelfor": {
      "command": "npx",
      "args": ["-y", "@wheelfor/mcp"]
    }
  }
}

Usage

Once connected, ask your AI assistant:

• "I can't decide between React, Vue, or Svelte — pick one"
• "Create a wheel for our team retro: Start, Stop, Continue, More Of, Less Of"
• "Spin wheelfor.com/wheel/lunch-spots"
• "Add burgers to my lunch-spots wheel" (requires edit key from creation)

Tool Reference

create_wheel

Creates a new wheel on wheelfor.com.

Parameter	Type	Required	Description
name	string	✓	Short title
choices	string[]	✓	Items on the wheel
description	string	✓	One sentence describing the wheel
theme	string	✓	Visual theme (see below)
longDescription	string		2–3 paragraphs on use cases
usageHint	string		Brief instruction for visitors
choiceNounSingular	string		Word for one choice (e.g. "restaurant")
choiceNounPlural	string		Plural form (e.g. "restaurants")

Themes: Fresh Air · Popcorn · Playground · Sprinkles · Chalkboard · Buddy System · Garden Party · Marshmallow

Returns the wheel URL and an edit key for future updates.

spin_wheel

Parameter	Type	Required	Description
slug	string	✓	Wheel slug or full URL

Returns the winning choice and a shareable result URL.

update_wheel

Parameter	Type	Required	Description
slug	string	✓	Wheel slug
editKey	string	✓	Edit key from creation
name	string		New title
choices	string[]		New choices list
theme	string		New theme
description	string		New description

decide

Parameter	Type	Required	Description
options	string[]	✓	Options to choose from
topic	string		What the decision is about

Picks a random option immediately, then creates a permanent wheel for future spins.

License

MIT