@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

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.

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

Returns the winning choice and a shareable result URL.

update_wheel

decide

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

License

MIT