WoWok Agent (MCP Server)

Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.

GitHub: https://github.com/wowok-ai/agent

AI Skills: https://github.com/wowok-ai/skills

Docs: https://github.com/wowok-ai/docs/

Quick Start

1. Install MCP Server

{
  "mcpServers": {
    "wowok": {
      "command": "npx",
      "args": [
        "-y",
        "@wowok/agent-mcp"
      ]
    }
  }
}

2. Use WoWok Skills (Recommended)

Skills significantly reduce the learning curve and usage difficulty of the MCP Server.

npm install -g @wowok/skills

Skills provide structured guidance for AI assistants:

• Complex system building — Dependency chains, build order, step-by-step patterns
• Tool usage failures — Correct parameter formats, tool selection, error recovery
• Safety & authorization — User confirmation for important operations

Available Skills (Organized by Role)

| Skill | Role | Purpose | |-------|------|---------| | wowok-order | 👤 Customer | Order lifecycle — place orders, track progress, submit disputes, claim compensation | | wowok-provider | 🏪 Provider | Service provider guide — create Service, design Machine, configure Allocators | | wowok-machine | 🏪 Provider | Workflow design — state machines, node definitions, progress tracking | | wowok-arbitrator | ⚖️ Arbitrator | Arbitration service — dispute resolution, voting organization, fee management | | wowok-guard | 🛠️ Shared | Guard design mastery — programmable trust rules, multi-signature authorization | | wowok-messenger | 🛠️ Shared | Encrypted messaging — E2E communication, WTS evidence, conversation management | | wowok-output | 🛠️ Shared | Output processing — post-process responses for human-readable presentation | | wowok-tools | 🛠️ Shared | MCP tool usage mastery — 13+ tools, parameter formats, schema references | | wowok-safety | 🛠️ Shared | Safety protocol — dry-run validation, user confirmation checkpoints |

Role-Based Skill Selection

• Use wowok-order when user acts as a customer/buyer placing orders
• Use wowok-provider + wowok-machine when user is a merchant/service provider
• Use wowok-arbitrator when user operates dispute resolution services
• Use wowok-tools + wowok-safety** + wowok-output (always loaded) for all roles
• Use wowok-guard when designing complex validation rules

Note: For detailed installation instructions for different AI clients (Claude Code, OpenAI Codex, Trae IDE, Cursor, etc.), see the WoWok Skills repository.