Skip to content
werk

MCP Tools

werk exposes its full capability surface through the Model Context Protocol (MCP). Start the server with:

Terminal window
werk mcp

This opens a stdio transport. Connect any MCP-compatible client (Claude Code, Claude Desktop, custom agents) to interact with the tension structure programmatically.

This reference is under construction. Tool schemas will be generated from the MCP server’s self-description.

Configuration

Section titled “Configuration”

Add to your MCP client configuration:

{
  "mcpServers": {
    "werk": {
      "command": "werk",
      "args": ["mcp"]
    }
  }
}

Tool categories

Section titled “Tool categories”

Reading tools

Section titled “Reading tools”

Tools that query tension state without mutation.

show, list, tree, stats, log, search

Gesture tools

Section titled “Gesture tools”

Tools that mutate tension state. Each creates a recorded gesture.

add, reality, desire, resolve, release, reopen, position, hold, move, split, merge, note, horizon, snooze, recur, epoch

System tools

Section titled “System tools”

Tools for workspace and configuration management.

config, flush, batch

Conventions for agents

Section titled “Conventions for agents”
  • Always use structured (JSON) output — the MCP tools return typed responses.
  • Read before writing. Use show or list to understand current state before proposing mutations.
  • Every mutation is a gesture. The logbase records what you did and when.
  • Respect the practitioner’s position sequence. Don’t reorder without being asked.