About io.github.wheelfor/mcp
io.github.wheelfor/mcp is an MCP server published by wheelfor in the Developer Tools category: mCP server for wheelfor.com — create, spin, and manage decision wheels.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add io-github-wheelfor-mcp -- npx -y @wheelfor/mcpnpx -y @wheelfor/mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
create_wheelCreate a new spinning wheel from a list of options
Parameters not published.
decidePick randomly from a list and create a permanent wheel in one step
Parameters not published.
spin_wheelSpin an existing wheel and get a random result with a shareable URL
Parameters not published.
update_wheelUpdate a wheel's choices, name, or theme using its edit key
Parameters not published.
Ask AI
Ask AI about io.github.wheelfor/mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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
| 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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.