@wayofmono/wayofteams-tools

WayOfTeams MCP + REST tools, as a pi extension

Connect the pi coding agent to your WayOfTeams workspace — tickets, plans, docs, standups, kanban, knowledge, memory and more — over the internet, for any tenant, with a single install.

Install · Configure · Commands · Interactive Group Manager · Presets · How it works

pi-package · MCP · REST · client-first · interactive

Why this extension

Pi doesn't ship a built-in MCP client, and generic MCP bridges can't do WayOfTeams' Bearer auth. wayofteams-tools is ours: a first-class MCP client and a direct REST client, built client-first so your whole team can drive WayOfTeams from pi.

• Full surface — the WayOfTeams MCP exposes ~269 tools across 12 domains: tickets, plans, docs, standups, kanban, ideas, skills, templates, thoughts, knowledge, rules, memory/anchor, agents (orchestration + multi-agent), versions, and more.
• MCP + REST dual path — talks MCP first; falls back to the REST adapter (/api/v1/tools) and direct REST endpoints when MCP is unavailable, so the chat keeps working.
• Both endpoint families — supports the legacy /mcp monolith and the v2 /mcp/v2 domain-split surfaces, auto-probing the healthiest.
• Client-first auth — per-user JWT, resolved from env → pi settings → token file. Never hardcoded, never shared.
• Entitlement-aware — access denials surface as recoverable messages ("access expired", "tier missing"), not cryptic network errors.
• Multi-agent ready — registers your agent identity on startup and exposes the coordinator / work-registry / messaging tools (WOTEAMS-322).
• Interactive Group Manager — press Ctrl+Shift+W for a collapsible panel above the editor to enable/disable tool groups visually.

Requirements

• pi (0.84+) — loads this extension via jiti, no build step.
• A WayOfTeams account and an MCP token (get it from your WayOfTeams → Settings → MCP dashboard).

Install

pi install npm:@wayofmono/wayofteams-tools

That's it. pi discovers the package, loads src/index.ts, and the tools appear in the session (new sessions auto-load it; run /reload to pick up changes in an existing one).

From this monorepo during development:

pi install ./packages/@wayofmono/wayofteams-tools

Configure

The extension resolves a token in this order (first hit wins) — never hardcoded:

1. Environment variable — WAYOFTEAMS_MCP_TOKEN

2. pi settings.json (~/.pi/agent/settings.json):

   {
     "wayofteams": {
       "token": "<your-jwt>",
       "endpoint": "auto",          // "auto" | "v2" | "legacy" | "rest"
       "enabledGroups": [...],      // optional: override default enabled groups
       "disabledGroups": [...]      // optional: explicitly disable groups
     }
   }
   

3. Token file — ~/.config/opencode/.wayofteams-mcp-token

The easiest way is the /wayofteams-login command (see below) — it verifies the token live against the server, then persists it to settings.json for you.

Security: tokens are per-user JWTs. A WayOfTeams founders/superadmin token would bypass all entitlements by design — always use a token scoped to your own profile.

Commands

Command	What it does
/wayofteams status	Active surface, endpoint, tool count, token state
/wayofteams endpoint	Re-probe surfaces (v2 → legacy → REST) and reconnect
/wayofteams-login <token>	Verify a token live, save it, reconnect
/wayofteams-groups <subcommand>	Manage tool groups (see below)
/wayofteams-presets	(Reserved) Interactive preset selector

Tool Group Management: /wayofteams-groups

Subcommand	Description
/wayofteams-groups list	Show all 13 groups with ✓/✗/○ status
/wayofteams-groups enable <group>	Enable one group
/wayofteams-groups disable <group>	Disable one group
/wayofteams-groups reset	Reset to defaults (7 primary groups)
/wayofteams-groups enable-all	Enable ALL 13 groups
/wayofteams-groups disable-all	Disable ALL (only discovery tools active)
/wayofteams-groups enable-multiple <g1,g2,g3>	Enable multiple (comma-separated)
/wayofteams-groups disable-multiple <g1,g2,g3>	Disable multiple
/wayofteams-groups preset <name>	Apply a preset (see below)

Presets

Preset	Groups Enabled	Use Case
minimal	tickets	Lowest context, just ticket work
standard	tickets, kanban, team, agents, knowledge, memory, admin	Default (7 primary groups)
full	All 13 groups	Maximum context
team-only	team, agents	Coordination only
knowledge-only	knowledge, memory	Research/docs only
google-gmail-only	google-gmail	Just Gmail
google-drive-only	google-drive	Just Drive
google-docs-only	google-docs	Just Docs
google-sheets-only	google-sheets	Just Sheets
google-calendar-only	google-calendar	Just Calendar
google-all	All 5 Google services	Full Google Workspace

Usage: /wayofteams-groups preset minimal

Interactive Group Manager

Press Ctrl+Shift+W to toggle a collapsible panel above the editor:

● WayOfTeams Groups (7/13)
  ✓ tickets: Tickets & Plans (enabled)
  ✓ kanban: Kanban Boards (enabled)
  ✓ team: Team & Standups (enabled)
  ✓ agents: Multi-Agent Orchestration (enabled)
  ✓ knowledge: Knowledge Base (enabled)
  ✓ memory: Memory & Anchors (enabled)
  ✓ admin: Admin & Skills (enabled)
  ○ google-gmail: Google Gmail (default-off)
  ○ google-drive: Google Drive (default-off)
  ○ google-docs: Google Docs (default-off)
  ○ google-sheets: Google Sheets (default-off)
  ○ google-calendar: Google Calendar (default-off)
  ○ obsidian: Obsidian Sync (default-off)

└─ ↑↓ navigate  Enter toggle  P presets  C collapse  Q quit

Keyboard Controls

Key	Action
↑ / ↓ / j / k	Navigate groups
Enter	Toggle selected group (enable/disable)
C	Collapse/expand panel
P	Open preset menu (shows available presets)
Q / Esc	Close panel

Visual Status

Symbol	Color	Meaning
✓	green	Enabled
✗	red	Disabled
○	dim	Default-off (not in enabled/disabled lists)

Tool Groups (13 total)

Group	Tools	Domain	Default
tickets	tickets_*, plans_*	core	✓
kanban	kanban_*, boards_*, cards_*	collab	✓
team	standups_*, notifications_*, team_*	collab	✓
agents	agent_*, coordinator_*, work_*, claim_*, conflicts_*	agents	✓
knowledge	docs_*, knowledge_*, personal_*, templates_*, ideas_*, versions_*, thoughts_*	knowledge	✓
memory	anchors_*, memory_*, context_*, pr_review_*	memory	✓
admin	skills_*, rules_*, config_*, deploy_*	admin	✓
google-gmail	google_gmail_*, gmail_*	google-gmail	✗
google-drive	google_drive_*, drive_*	google-drive	✗
google-docs	google_docs_*, docs_*	google-docs	✗
google-sheets	google_sheets_*, sheets_*	google-sheets	✗
google-calendar	google_calendar_*, calendar_*	google-calendar	✗
obsidian	obsidian_*	obsidian	✗

How it works

pi session
   │
   ├─ load @wayofmono/wayofteams-tools (via jiti)
   │    └─ register control-plane + discovery tools (safe during load)
   │    └─ resolve token (env → settings → file)  [no hardcode]
   │    └─ probe surfaces: v2 gateway → legacy /mcp → REST adapter
   │         └─ pick healthiest, register its tool set
   │    └─ register /wayofteams commands
   │    └─ register `Ctrl+Shift+W` shortcut for group manager widget
   │
   └─ session_start
        ├─ activate discovery/status tools (runtime is now bound)
        ├─ register agent identity (update_my_work)
        ├─ bind UI context for group manager widget
        └─ ready: model calls tools; matching tools activate on demand

• Dynamic tool loading — only the discovery/status tools start active; when the model needs a specific tool, search_tools/get_tool_schema results activate it additively via pi.setActiveTools (keeps the prompt small instead of flooding 269 schemas).
• Multi-agent — registers update_my_work on start and exposes agent_register, agent_list, agent_claim_files, agent_check_conflicts, agent_send_message, agent_coordinator_status so pi agents cooperate with others.
• Context budget aware — enable only the tool groups you need. The model only sees schemas for enabled groups.

What the model can do

After setup you can ask pi things like:

• "List my open tickets and their priorities."
• "Create a feature ticket about … — write the description as markdown."
• "Show today's standups for the team."
• "Search the knowledge base for … ."
• "What cards are on the kanban board?"
• "Download the latest published version notes."
• "Disable Google services, I don't need them right now."

The model discovers the exact tools via search_tools and calls them directly.

Development

Requires Node 22+, and (optionally) pi for the live-load smoke test.

# from the womono monorepo root
pnpm install
pnpm --filter @wayofmono/wayofteams-tools test     # vitest (28 tests)
pnpm --filter @wayofmono/wayofteams-tools typecheck
pnpm --filter @wayofmono/wayofteams-tools build    # tsc -> dist/

# smoke-load the extension exactly as pi does (must print "... loaded ...")
cd packages/@wayofmono/wayofteams-tools
echo "list connected tools" | pi -p -e ./src/index.ts

Tests cover the pure modules (src/schema.ts, src/token.ts, src/server.ts, src/client/*) — no pi runtime required. Rebuild dist/ before publishing.

Package layout

Area	Files	Notes
Entry	src/index.ts	registration-only during load; activation deferred to session_start (pi's runtime-not-initialized contract)
Clients	src/client/mcp.ts, src/client/rest.ts	pure JSON-RPC / REST, unit-testable
Surface	src/server.ts	legacy + v2 catalog, auto-probe order
Auth	src/token.ts, src/config.ts	JWT resolution + settings I/O
Registry	src/registry.ts	registerTool bridge + dynamic activation
Tools	src/tools/{router,control,fallbacks}.ts	discovery, control-plane, REST fallbacks
Widgets	src/widgets/group-manager.ts	interactive overlay for group management
Schema	src/schema.ts	JSON Schema → TypeBox (pure)

License

MIT © WayOf / WayOfMono