io.github.wheelfor/mcp
MCP server for wheelfor.com — create, spin, and manage decision wheels
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@wheelfor/mcpclaude mcp add io-github-wheelfor-mcp -- npx -y @wheelfor/mcp@1.0.1
{
"mcpServers": {
"io-github-wheelfor-mcp": {
"command": "npx",
"args": [
"-y",
"@wheelfor/mcp@1.0.1"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
@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
Questions fréquentes
Qu'est-ce que io.github.wheelfor/mcp ?
MCP server for wheelfor.com — create, spin, and manage decision wheels
Comment installer io.github.wheelfor/mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add io-github-wheelfor-mcp -- npx -y @wheelfor/mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.wheelfor/mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.wheelfor/mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.wheelfor/mcp ?
Il est publié par wheelfor. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.