{
  "markdown": "# @wheelfor/mcp\n\nMCP server for [wheelfor.com](https://wheelfor.com) — create, spin, and manage shareable decision wheels from any MCP-compatible AI client.\n\nWorks with Claude Desktop, Cursor, Windsurf, VS Code, and any other MCP host. No account required.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `create_wheel` | Create a new spinning wheel from a list of options |\n| `spin_wheel` | Spin an existing wheel and get a random result with a shareable URL |\n| `update_wheel` | Update a wheel's choices, name, or theme using its edit key |\n| `decide` | Pick randomly from a list and create a permanent wheel in one step |\n\n## Installation\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"wheelfor\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@wheelfor/mcp\"]\n    }\n  }\n}\n```\n\n**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"wheelfor\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@wheelfor/mcp\"]\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"wheelfor\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@wheelfor/mcp\"]\n    }\n  }\n}\n```\n\n## Usage\n\nOnce connected, ask your AI assistant:\n\n- *\"I can't decide between React, Vue, or Svelte — pick one\"*\n- *\"Create a wheel for our team retro: Start, Stop, Continue, More Of, Less Of\"*\n- *\"Spin wheelfor.com/wheel/lunch-spots\"*\n- *\"Add burgers to my lunch-spots wheel\"* (requires edit key from creation)\n\n## Tool Reference\n\n### `create_wheel`\n\nCreates a new wheel on wheelfor.com.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `name` | string | ✓ | Short title |\n| `choices` | string[] | ✓ | Items on the wheel |\n| `description` | string | ✓ | One sentence describing the wheel |\n| `theme` | string | ✓ | Visual theme (see below) |\n| `longDescription` | string | | 2–3 paragraphs on use cases |\n| `usageHint` | string | | Brief instruction for visitors |\n| `choiceNounSingular` | string | | Word for one choice (e.g. `\"restaurant\"`) |\n| `choiceNounPlural` | string | | Plural form (e.g. `\"restaurants\"`) |\n\n**Themes:** `Fresh Air` · `Popcorn` · `Playground` · `Sprinkles` · `Chalkboard` · `Buddy System` · `Garden Party` · `Marshmallow`\n\nReturns the wheel URL and an edit key for future updates.\n\n### `spin_wheel`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `slug` | string | ✓ | Wheel slug or full URL |\n\nReturns the winning choice and a shareable result URL.\n\n### `update_wheel`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `slug` | string | ✓ | Wheel slug |\n| `editKey` | string | ✓ | Edit key from creation |\n| `name` | string | | New title |\n| `choices` | string[] | | New choices list |\n| `theme` | string | | New theme |\n| `description` | string | | New description |\n\n### `decide`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `options` | string[] | ✓ | Options to choose from |\n| `topic` | string | | What the decision is about |\n\nPicks a random option immediately, then creates a permanent wheel for future spins.\n\n## License\n\nMIT\n",
  "bytes": 3421,
  "sha": "eef04b5edf584f462b21ea29ce10efdc8f9a1c4b509519836872b6e730cda4fc",
  "repo_slug": "wheelfor/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_wheelfor_mcp_d455e9ab/readme"
}