npm package: @sisyphus-consulting/wuwei-mcp
Description: Wu Wei MCP Server - A hybrid architecture MCP server for Wu Wei Cards. Fetches full card data from the cloud while keeping summaries local for zero-cost browsing.
Author: Sisyphus Consulting Private Limited
Latest version: 1.1.3

# Wu Wei MCP Server

Use [Wu Wei Cards](https://wuwei.cards) — 50 metaphorical object cards — directly within Claude Desktop to enhance facilitation, coaching, therapy, and team conversations.

## What is Wu Wei?

Wu Wei Cards are a deck of 50 metaphorical object cards used by coaches, therapists, HR professionals, educators, and facilitators. Each card features an everyday object that serves as a gentle doorway into meaningful conversation.

**Key principles:**
- No fixed meanings — participants project their own meaning onto the cards
- Effortless action (wu wei) — follow the energy of the group rather than forcing outcomes
- Right to pass — always available, never questioned
- Facilitator as space-holder, not expert or interpreter

Check out [wuwei.cards](https://wuwei.cards) for more digital tools, including the free Card Spread Studio and Story Weaver.

## Installation

```bash
npm install -g @sisyphus-consulting/wuwei-mcp
```

Or use directly with npx (no installation required):

```bash
npx -y @sisyphus-consulting/wuwei-mcp
```

## Claude Desktop Setup

Add to your Claude Desktop configuration (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "wuwei": {
      "command": "npx",
      "args": ["-y", "@sisyphus-consulting/wuwei-mcp"]
    }
  }
}
```

> **Note for Windows Users:** If Claude Desktop fails to connect and you see an error like `ENOENT: no such file or directory, lstat '...\AppData\Roaming\npm'` in your logs, this is a known Node.js/npm bug on Windows. To fix it, you can simply create the missing folder by running this in your Command Prompt:
> `mkdir %APPDATA%\npm`
> Alternatively, you can install the server globally first (`npm install -g @sisyphus-consulting/wuwei-mcp`) and change the config to use `"command": "wuwei-mcp.cmd"` and `"args": []`.

## What You Can Do

Once connected, you can ask Claude to:

### Browse Cards
- **"What cards do you have?"** — See all 50 cards with one-line descriptions
- **"What cards relate to conflict?"** — Find cards by theme (conflict, transition, burnout, leadership, etc.)
- **"What professions are supported?"** — See the 15 professional contexts with specific guidance

### Explore Specific Cards
- **"Tell me more about the butterfly card"** — Get full details: keywords, metaphor, facilitation prompts, profession-specific guidance
- **"Show me the blind men and elephant card"** — Display the card image alongside details
- **"How would I use the fire card in a therapy session?"** — Get trauma-sensitive guidance and prompts

### Facilitation Support
- **"I need cards for a team that's struggling with communication"** — Get themed card recommendations
- **"What card would help someone dealing with burnout?"** — Find relevant metaphors
- **"How do I introduce these cards to a new group?"** — Get facilitation guidance

## Available Tools

| Tool | Description |
|------|-------------|
| `get_all_cards` | List all 50 cards with one-line descriptions |
| `get_available_professions` | List all 15 supported professions |
| `get_available_themes` | List all 40+ conversation themes |
| `get_cards_by_theme` | Find cards matching a specific theme |
| `get_card_by_slug` | Get full details for a specific card |
| `get_card_image_by_slug` | Display a card image |

## Example Conversations

**Exploring themes:**
> *You:* "I'm working with someone who feels isolated but is reaching out for connection. What cards might help?"
> 
> *Claude:* "Let me find cards related to isolation, hope, and communication..."
> 
> The following cards are relevant to 'isolation': man_sitting_alone_on_bench, bottle_with_note, person_trapped_behind_bars

**Getting card details:**
> *You:* "Tell me about the bottle with note card"
> 
> *Claude:* "Fetching the details for you..."
> 
> **Keywords:** isolation, hope, aimlessness, lost dreams, communication, connection, memory, nostalgia...
> 
> **Metaphor:** Act of faith against improbability — putting words out with no guaranteed recipient. What message says and who participant hopes finds it...

**Showing the card:**
> *You:* "Can you show me that card?"
> 
> *Claude:* ![Wu Wei Card - bottle_with_note](https://wuwei.cards/assets/images/cards/wu-wei-card-16.webp)

## Supported Professional Contexts

The cards include specialized guidance for:
- **Coaches** — goal setting, limiting beliefs, life transitions
- **Therapists** — trauma processing (with high-charge card cautions)
- **HR Professionals** — organizational culture, change management
- **Managers & Team Leaders** — team dynamics, psychological safety
- **Educators** — classroom discussions, student check-ins
- **Mediators** — conflict resolution, perspective sharing
- **Career Counselors** — aspirations, barriers, transitions
- **Healthcare Providers** — patient emotions, coping conversations
- **Facilitators** — icebreakers, session design
- And 6 more professions...

## Learn More

- **[Wu Wei Cards](https://wuwei.cards)** — Explore the full deck and free digital tools
- **[Card Spread Studio](https://wuwei.cards/spread-studio)** — Create custom card spreads (free)
- **[Story Weaver](https://wuwei.cards/story-weaver)** — Guided card narratives (free)
- **[Model Context Protocol](https://modelcontextprotocol.io)** — Learn about MCP

## License

MIT © Sisyphus Consulting