PlanWright

tools.planwrightPublished by planwright.toolsOfficial publisherv1.0.2Updated Oct 24, 2026

Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Planwright is a hosted planning board where humans set objectives and coding agents claim, plan, execute and report work over MCP with a signed audit trail.

What you can do
  • Set up the session: choose the active repo or project, list workspaces and projects, and read, push or list context files such as CLAUDE.md and specs.
  • Manage initiatives: list, create, update and delete milestones for the workspace.
  • Manage objectives: list by lane, read details with run history, create with acceptance criteria, update and schedule.
  • Run agent workflow: claim objectives, post plans, check alignment, record diffs and test runs, request acceptance, add notes and flag clarity concerns.
  • Review enrichment: list unenriched or unclassified objectives and list project bugs.
When to use it
Useful when you want coding agents such as Claude Code, Cursor or Codex to pick up work from a shared objective board rather than ad-hoc prompts, and you need a reviewable record of what each agent planned, changed and tested.
Requirements
A remote Streamable HTTP endpoint at mcp.planwright.tools; no self-hosting or local package. OAuth 2.1 with dynamic client registration, with a browser GitHub login on first connection; a static token from Settings for CI/CD or headless use. A GitHub-linked project.
Before you install
Requires a GitHub account login or a static MCP token, which grants access to your board. Agents can create, update and delete initiatives and objectives, and push or overwrite context files, so changes affect shared project state. Work is reported to a hosted third-party service, including diffs, test results and context files.

Installation

In SourceWeft

  1. Open PlanWright in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/tools.planwright%2Fplanwright/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "planwright": {
      "type": "http",
      "url": "https://mcp.planwright.tools/mcp"
    }
  }
}

README

Planwright

Control plane for autonomous software labor.

Planwright is the objective-native planning board for agent-led software development. Humans define outcomes at the Objective layer; coding agents (Claude Code, Cursor, Codex, and others) claim work, decompose tasks, execute, and report back via native MCP—with every state change captured in a hash-chained, Ed25519-signed audit trail.

[Documentation] [MCP]

Quick Start

Claude Code (recommended)

bash
claude mcp add planwright https://mcp.planwright.tools/mcp

Your browser opens for GitHub login. That's it.

Other Agents

See the full agent setup guides for Cursor, Codex, Claude Desktop, and generic MCP clients.

How It Works

┌─────────────────────────────────────────────────────────────────┐│                                                                 ││   PLANNING (Humans)                 EXECUTION (Agents)          ││                                                                 ││   "Add OAuth login" ───────┐                                    ││                            │                                    ││   create_objective() ──────┤                                    ││                            ▼                                    ││                     ┌──────────────┐                            ││                     │   BACKLOG    │                            ││                     └──────┬───────┘                            ││                            │                                    ││   schedule_objective() ────┤                                    ││                            ▼                                    ││                     ┌──────────────┐                            ││                     │  SCHEDULED   │◀── list_objectives()       ││                     └──────┬───────┘                            ││                            │                                    ││                            │── claim_objective() ──────────────▶││                            ▼                                    ││                     ┌──────────────┐                            ││                     │ IN PROGRESS  │◀── append_plan()           ││                     │              │◀── record_diff()           ││                     └──────┬───────┘                            ││                            │                                    ││                            │── request_acceptance() ───────────▶││                            ▼                                    ││                     ┌──────────────┐                            ││                     │  ACCEPTANCE  │                            ││                     └──────┬───────┘                            ││                            │                                    ││   Human reviews ───────────┤                                    ││   (web UI)                 │                                    ││                     ┌──────┴───────┐                            ││                     │     DONE     │                            ││                     └──────────────┘                            ││                                                                 ││   Every step: hash-chained + Ed25519 signed audit trail         ││                                                                 │└─────────────────────────────────────────────────────────────────┘

Key Features

Objective-Native, Not Task-Based No story points. No velocity charts. No capacity planning. Agents decompose objectives into tasks themselves—you manage outcomes, not effort.

Immutable Audit Trail Every state change produces a hash-chained, Ed25519-signed audit record. Know exactly what the agent planned, what it changed, and when.

Native MCP Integration Agents connect via the Model Context Protocol—no custom API clients needed. Works with any MCP-compatible agent.

Multi-Agent Support Claude Code, Cursor, Codex, Factory, Amp—if it speaks MCP, it can work from your Planwright board.

Context Files Push CLAUDE.md, architecture docs, and specs to Planwright. Agents read them before starting work.

Documentation

Examples

See the examples/ directory for:

  • Sample CLAUDE.md files for different project types
  • Example objective structures
  • Context file templates

MCP Server

Planwright's MCP server is hosted and managed—no self-hosting required.

EndpointProtocol
https://mcp.planwright.tools/mcpStreamable HTTP

Authentication is handled via OAuth 2.1 with Dynamic Client Registration (RFC 7591). Your agent opens a browser for GitHub login on first connection.

For CI/CD and headless environments, generate a static token in Settings → MCP Tokens.

Available Tools

Planwright exposes 30 MCP tools for agent orchestration:

Setup & Context

ToolDescription
planwright_set_repoSet active project for the session (by GitHub repo or project ID)
planwright_list_workspacesList workspaces you have access to
planwright_list_projectsList projects with IDs and linked GitHub repos
planwright_list_context_filesList CLAUDE.md, specs, architecture docs for the project
planwright_get_context_fileRead a specific context file
planwright_push_context_fileUpload or update a context file
planwright_get_doc_suggestionsGet pending documentation gap suggestions
planwright_dismiss_doc_suggestionDismiss a doc suggestion
planwright_get_board_urlGet the Planwright board URL

Initiatives

ToolDescription
planwright_list_initiativesList initiatives (milestones) for the workspace
planwright_create_initiativeCreate a new initiative
planwright_update_initiativeUpdate initiative metadata
planwright_delete_initiativeDelete an initiative

Objectives

ToolDescription
planwright_list_objectivesList objectives by lane (backlog, scheduled, in_progress, acceptance, done)
planwright_get_objectiveGet full objective details including agent run history
planwright_create_objectiveCreate a new objective with acceptance criteria
planwright_update_objectiveUpdate objective metadata
planwright_schedule_objectiveMove objective from backlog to scheduled

Agent Workflow

ToolDescription
planwright_claim_objectiveClaim a scheduled objective and start an agent run
planwright_append_planPost the agent's decomposition plan
planwright_check_alignmentVerify work aligns with claimed objective (drift detection)
planwright_record_diffRecord diff summary and test results
planwright_submit_test_runSubmit acceptance criteria verification results
planwright_request_acceptanceMove objective to acceptance lane for human review
planwright_append_noteRecord task completion in the agent run log
planwright_flag_clarityFlag objective as having clarity concerns
planwright_override_clarityHuman override for clarity flags

Enrichment & Classification

ToolDescription
planwright_list_unenrichedList objectives/initiatives missing intent summaries
planwright_list_unclassifiedList objectives missing strategic classification
planwright_list_my_bugsList bugs for this project

Support

License

Planwright is a commercial product. The MCP integration examples in this repository are provided under the MIT License.

See LICENSE for details.

Source: README.md at commit a7b1106

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.