Wheelfor

from wheelfor

Create, spin, and manage shareable decision wheels from any AI assistant — no account required.

🔥🔥✓ VerifiedFreeQuick setup

@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

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.

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)