Wheelfor

io.github.wheelforPublished by GitHub account wheelforv1.0.1Updated Oct 28, 2026

MCP server for wheelfor.com — create, spin, and manage decision wheels

VerifiedSTDIODesktop onlyProductivity & WorkflowMedia & Design

Overview

AI-generated overview

Creates, spins and updates shareable decision wheels on wheelfor.com, letting an assistant pick randomly from a list of options.

What you can do
  • Create wheels from a list of options, with a name, description and visual theme
  • Spin an existing wheel by slug or URL and get a random winning choice plus a shareable result link
  • Update a wheel's choices, name, theme or description using its edit key
  • Pick a random option from a list and create a permanent wheel for it in one step
When to use it
Useful when you want an assistant to settle a choice between options, or to build and share a themed spinning wheel for a team activity, poll or casual decision.
Requirements
Runs as a local process via npx from the npm package @wheelfor/mcp, configured in an MCP host such as Claude Desktop, Cursor, Windsurf or VS Code. No account, API key or environment variables are declared; network access to wheelfor.com is implied.
Before you install
Wheels are created on a public third-party site and are shareable by URL, so anything you put in the options becomes public. Updates require the edit key returned at creation, so losing it means the wheel can no longer be changed. No credentials are requested.

Installation

In SourceWeft

  1. Open Wheelfor in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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

ToolDescription
create_wheelCreate a new spinning wheel from a list of options
spin_wheelSpin an existing wheel and get a random result with a shareable URL
update_wheelUpdate a wheel's choices, name, or theme using its edit key
decidePick randomly from a list and create a permanent wheel in one step

Installation

Claude Desktop

Add to claude_desktop_config.json:

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:

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

Windsurf

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

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.

ParameterTypeRequiredDescription
namestring✓Short title
choicesstring[]✓Items on the wheel
descriptionstring✓One sentence describing the wheel
themestring✓Visual theme (see below)
longDescriptionstring2–3 paragraphs on use cases
usageHintstringBrief instruction for visitors
choiceNounSingularstringWord for one choice (e.g. "restaurant")
choiceNounPluralstringPlural 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

ParameterTypeRequiredDescription
slugstring✓Wheel slug or full URL

Returns the winning choice and a shareable result URL.

update_wheel

ParameterTypeRequiredDescription
slugstring✓Wheel slug
editKeystring✓Edit key from creation
namestringNew title
choicesstring[]New choices list
themestringNew theme
descriptionstringNew description

decide

ParameterTypeRequiredDescription
optionsstring[]✓Options to choose from
topicstringWhat the decision is about

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

License

MIT

Source: README.md at commit 751ee9e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts