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. Install WoWok Skills (Recommended)

Skills significantly reduce the learning curve and usage difficulty of the MCP Server. They provide structured guidance for AI assistants on complex system building, tool usage, and safety protocols. See the WoWok Skills repository for full details.

# Personal (global) — available in all sessions:
npm install -g @wowok/skills

# Project (team sharing) — commit to git for collaboration:
cd your-project
wowok-skills init          # Claude Code (default)
wowok-skills init --target agents    # Trae IDE
wowok-skills init --target all       # All 10 supported clients

Supported clients: Claude Code, OpenAI Codex, ChatGPT Desktop (Codex Mode), Trae IDE, CodeBuddy, Cursor, Windsurf, Qoder, Roo Code, GitHub Copilot.

Note: The skills package auto-installs and configures the @wowok/agent-mcp MCP server. Set WOWOK_SKILLS_NO_MCP=1 to skip MCP management.

Available Skills

Always loaded (3 skills — foundational layer):

| Skill | Purpose | |-------|---------| | wowok-tools | MCP tool reference — 17 sub-tools, schema-gated execution, constraints | | wowok-safety | Safety protocol — dry-run → confirm → execute, immutability rules | | wowok-output | Output processing — address resolution, name mapping, data visualization |

On-demand (11 skills — loaded by context):

| Skill | Role | Purpose | |-------|------|---------| | wowok-provider | 🏪 Provider | Service provider guide — create Service, Machine, Allocators, order fulfillment | | wowok-machine | 🏪 Provider | Workflow design — state machines, node/pair/forward graph, publish lifecycle | | wowok-order | 👤 Customer | Order lifecycle — due diligence, consensus, order creation, progress, arbitration | | wowok-arbitrator | ⚖️ Arbitrator | Arbitration service — dispute resolution, weighted voting, fee management | | wowok-guard | 🛠️ Shared | Guard design — programmable trust rules, 4 data sources, 33 constraints | | wowok-messenger | 🛠️ Shared | Encrypted messaging — E2E communication, WTS evidence, anti-spam | | wowok-onboard | 🆕 New User | First-touch onboarding — 10-round dialogue from zero to first published Service | | wowok-scenario | 🛠️ Shared | Industry mode templates — freelance, rental, education, travel presets | | wowok-planner | 🛠️ Shared | Planning — converts natural language intent into Object Dependency Graph (ODG) | | wowok-auditor | 🛠️ Shared | Pre-publish audit — Guard completeness, Machine soundness, 32 audit checks | | wowok-distill | 🏪 Provider | Distillation review — review AI-generated improvement proposals |

Tip: wowok-tools + wowok-safety + wowok-output are always loaded and serve all roles. Add role-specific skills (wowok-provider, wowok-order, wowok-arbitrator) as needed.