feat: add release management tools

[akhil-vamshi-konam]

Description

Adds MCP tools for Plane's releases domain.

Tools

• Releases — list, create, retrieve, update, delete
• Tags — list, create, retrieve, update, delete (version markers)
• Labels — list, create, update, delete, and attach/detach on a release
• Work items — list, and add/remove on a release
• Changelog - get, update

Organized as a plane_mcp/tools/releases/ package.

Type of Change

• Feature (non-breaking change which adds functionality)

References

Requires plane-sdk==0.2.20 (pinned in this PR).

Summary by CodeRabbit

• New Features
  • Added comprehensive release management tools, including creating, viewing, updating, deleting, and listing releases.
  • Added release tag and label management.
  • Added tools for linking work items to releases.
  • Added release changelog viewing and editing.
  • Added pagination support across release listings.
  • Expanded tooling documentation to reflect the broader feature set.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3a66e61d-c490-45b4-ad21-46284cd02243

📥 Commits

Reviewing files that changed from the base of the PR and between ec59f22 and 7968bed.

📒 Files selected for processing (2)

• CLAUDE.md
• plane_mcp/tools/__init__.py

🚧 Files skipped from review as they are similar to previous changes (1)

• plane_mcp/tools/init.py

---

📝 Walkthrough

Walkthrough

Adds release management MCP tools covering releases, tags, labels, linked work items, and changelogs. Shared helpers handle pagination and description conversion. Release registrars are wired into the server, and tooling documentation reflects the expanded tool set.

Changes

Release tool surface

Layer / File(s)	Summary
Release CRUD and shared helpers plane_mcp/tools/releases/base.py, plane_mcp/tools/releases/_helpers.py	Adds release listing, creation, retrieval, updates, deletion, status typing, and pagination parameter handling.
Tags and labels plane_mcp/tools/releases/tags.py, plane_mcp/tools/releases/labels.py	Adds tag CRUD, workspace label management, release label attachment and detachment, and paginated listing.
Linked work items plane_mcp/tools/releases/work_items.py	Adds paginated linked-work-item listing and add/remove operations with empty-input validation.
Release changelog operations plane_mcp/tools/releases/changelog.py, plane_mcp/tools/releases/_helpers.py	Adds changelog retrieval and updates with HTML, plain-text, and ProseMirror description inputs.
Registration and tooling documentation plane_mcp/tools/releases/__init__.py, plane_mcp/tools/__init__.py, CLAUDE.md	Registers the release tool groups and updates documented tool counts.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant MCP
  participant ReleaseRegistrar
  participant PlaneClient
  MCP->>ReleaseRegistrar: register release tools
  ReleaseRegistrar->>PlaneClient: call release, tag, label, work item, and changelog APIs
  PlaneClient-->>MCP: return release operation results

Loading

Possibly related PRs

• makeplane/plane-mcp-server#177: Both changes extend the MCP tool registration pipeline with a new domain registrar.

Suggested reviewers: prashant-surya

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change by introducing release management tools.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat-release-tools

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@tests/test_release_changelog.py`:
- Around line 31-40: Update the test helper _call to use FastMCP.Client with
StreamableHttpTransport against the configured live Plane instance instead of
constructing an in-process FastMCP server and monkeypatching
get_plane_client_context. Preserve the update_release_changelog invocation and
arguments while removing the offline mocked-client setup.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: be77522c-613c-4ef7-8135-830f945a96ef

📥 Commits

Reviewing files that changed from the base of the PR and between 7d8fe2a and ec59f22.

📒 Files selected for processing (5)

• plane_mcp/tools/releases/__init__.py
• plane_mcp/tools/releases/_helpers.py
• plane_mcp/tools/releases/changelog.py
• tests/test_integration.py
• tests/test_release_changelog.py

🚧 Files skipped from review as they are similar to previous changes (1)

• plane_mcp/tools/releases/init.py