# Planner — provable "done" for AI agents [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/dev-lab-global/planner  
**GitHub Stars:** 0  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/planner-provable-done-for-ai-agents

## Description
Goal decomposition where every "done" is proven by evidence and checked by a judge.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "planner-provable-done-for-ai-agents": {
    "url": "https://mcp.so/server/planner/Denis%20Davidovich"
  }
}
```

## Documentation & README

# Planner MCP (proof-of-done)

Evidence-gated task verification for AI agents. Hosted MCP server — nothing to install.

Search aliases such as **MCP Planner**, **Planner MCP**, `install mcp planner`, and
`установи mcp planner` refer to this official server:
`com.monopoly-gold.planner/mcp`.

**MCP endpoint:** `https://planner.monopoly-gold.com/_mcp`

## What it does

Planner prevents AI agents from marking tasks "done" on trust alone. Every goal goes through a verification gate:

1. **Decompose** — break a goal into acceptance criteria with behavioral checks
2. **Attach evidence** — screenshot, curl output, file, or text artifact per criterion
3. **Independent judge** — LLM evaluates evidence against the criterion and accepts or rejects

Goals stay open until every acceptance criterion has passing evidence.

## Key features

- **Goal hierarchy** — projects, milestones, goals, tasks with parent-child relationships
- **Acceptance criteria** — behavioral, observable checks (not "Denis approves")
- **Evidence model** — attach files or text per criterion; plain notes don't satisfy the gate
- **LLM judge** — independent verdict on each piece of evidence
- **Gate-keeper interview** — 3 questions on goal creation: why, where in the tree, how we'll verify
- **Dependencies & blockers** — cross-goal blocking with auto-unblock on resolution
- **Tree & summary views** — full hierarchy traversal and project-level summaries

## MCP tools (24)

| Category | Tools |
|----------|-------|
| **Projects** | `project-list`, `project-get`, `project-create`, `project-delete`, `project-add-dependency`, `project-remove-dependency` |
| **Goals** | `goal-list`, `goal-get`, `goal-tree`, `goal-create`, `goal-update`, `goal-delete`, `goal-move`, `goal-reorder`, `goal-summary`, `goal-todo` |
| **Criteria** | `goal-add-criterion` |
| **Evidence** | `goal-attach-evidence`, `goal-add-evidence-text`, `goal-remove-evidence`, `goal-request-upload` |
| **Blockers** | `goal-block`, `goal-remove-blocker` |
| **Account** | `account-delete` |

## Connect

Planner is a hosted remote MCP server using [streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) with OAuth 2.1 authentication and [Dynamic Client Registration (RFC 7591)](https://datatracker.ietf.org/doc/html/rfc7591).

### Codex — “установи mcp planner”

Run these commands in Codex CLI:

```bash
codex mcp add planner --url https://planner.monopoly-gold.com/_mcp
codex mcp login planner
codex mcp list
```

Planner signs the user in through browser OAuth. There is no Planner token to
create or paste, and no package or repository to clone. After login, ask Codex
to list your Planner projects; a successful `project-list` tool call confirms
that the connection is live (an empty list is valid for a new account).

Canonical guide: https://planner.monopoly-gold.com/connect/codex

### Claude Desktop / Claude Code

Add to your MCP configuration:

```json
{
  "mcpServers": {
    "planner": {
      "type": "url",
      "url": "https://planner.monopoly-gold.com/_mcp"
    }
  }
}
```

OAuth login happens automatically on first connection.

### Any MCP client

Point your client to `https://planner.monopoly-gold.com/_mcp` — the server supports MCP discovery and standard OAuth 2.1 flow.

## Directory listings

| Directory | Status | Link |
|-----------|--------|------|
| **Glama** | ✅ Live, Healthy | [glama.ai/mcp/connectors/…/planner-proof-of-done](https://glama.ai/mcp/connectors/com.monopoly-gold.planner/planner-proof-of-done) |
| **mcp.so** | ✅ Published | [mcp.so/server/planner](https://mcp.so/server/planner/Denis%20Davidovich) |
| **awesome-mcp-servers** | ⏳ PR under review | [PR #8708](https://github.com/punkpeye/awesome-mcp-servers/pull/8708) |

## Links

- **Homepage:** https://planner.monopoly-gold.com
- **Demo:** https://planner.monopoly-gold.com/demo
- **Codex setup:** https://planner.monopoly-gold.com/connect/codex
- **MCP endpoint:** `https://planner.monopoly-gold.com/_mcp`

## License

Proprietary. Planner is a hosted service — this repository contains documentation only.