English Français العربية

io.github.wheelfor/mcp

Official registry Other

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @wheelfor/mcp
Claude Code 
claude mcp add io-github-wheelfor-mcp -- npx -y @wheelfor/mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-wheelfor-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@wheelfor/mcp@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @wheelfor/mcp
  2. Tools
  3. Installation
  4. Usage
  5. Tool Reference
  6. License

@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:

{
  "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.

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

Frequently asked questions

What is io.github.wheelfor/mcp?

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

How do I install io.github.wheelfor/mcp?

It runs on your machine. In Claude Code: claude mcp add io-github-wheelfor-mcp -- npx -y @wheelfor/mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.wheelfor/mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.wheelfor/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.wheelfor/mcp?

It is published by wheelfor. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.