v0.3.1

Features

Page Collections

• Added collection tool with 13 operations for collection CRUD, page membership, and member access.

• Added page set_collection to file or move pages between collections.

• Added collection_id to page create.

Templates

• Added template tool for work item, page, and project templates at workspace/project scope.

• Project templates are workspace-scoped since they create projects.

Page Lifecycle

• Added page update, archive, and delete.

• Added parent_id to page create for page hierarchies.

• page archive supports restore via archive=false.

Workspace-Governed States

• Added workspace-scoped state support.

• Added guidance for both governed and project-managed states.

• Applied scoped handling to state, workitem_type, and workitem_property.

• Added validation for catalogue-only fields such as sequence and default.

Logging

• Added resource and action to every tools/call record.

• Added LOG_PAYLOADS (default true) to control request payload logging.

Improvements

Pages

• Optimized page set_collection to resolve the current collection directly — at most two requests, regardless of workspace size.

• page list and page retrieve now return parent_id and collection_id.

Templates

• template update now merges template_data instead of requiring unchanged fields.

• Template listings without project_id include both workspace and project templates.

Tool Surface

• Expanded to 30 tools and 204 operations, from 28 tools and 183 operations.

• New tools are appended to preserve the first 11 existing tool definitions byte-identical and retain cached prompt prefixes.

• Moved governance and toolkit conventions to plane_mcp/toolkit/README.md.

Fixes

Validation

• Fix project descriptions not appearing in the project overview

• Fixed triage incorrectly being exposed as a settable state group.

• Removed the unusable is_triage parameter.

• collection update now requires name or sort_order.

Error Messages

• Improved page set_collection errors for unsupported project pages.

• Fixed project-scoped template writes on governed workspaces to return the correct ownership guidance.

v0.3.1-rc1

What's Changed

• fix: describe what transfer_workitems actually does by @dheeru0198 in #209
• Release v0.3.1 by @akhil-vamshi-konam in #205
• fix: answer a call that names no action with the actions it could name by @dheeru0198 in #211

New Contributors

• @dheeru0198 made their first contribution in #209

Full Changelog: v0.3.0...v0.3.1-rc1

v0.3.0

Features

Tool Consolidation

• Consolidated the MCP tool surface from 177 tools to 28 action-dispatch tools covering 183 operations.

• Added one tool per Plane resource, with operations selected through an action parameter.

• Added centralized ACTIONS definitions to generate tool descriptions, annotations, and argument validation.

• Added MCP ToolAnnotations for improved client-side tool handling.

• Removed advertised output schemas to significantly reduce tool listing size and token usage.

Argument Handling

• Added automatic coercion for arguments encoded as strings, including lists, integers, and booleans.

• Added action-specific argument validation to reject unsupported parameters instead of silently dropping them.

Workspace Governance

• Added governance-aware routing and plan/feature gating for workspace-owned resources.

• Added handling for resources during workspace governance migrations.

Backwards Compatibility

• Preserved compatibility for 169 of 177 retired tool names, including legacy parameter names.

• Added explicit mappings and replacement guidance for the 7 legacy tools that cannot be directly mapped.

• Preserved get_pql_reference under its existing name.

Improvements

Work Items

• Fixed project-scoped work item counts to correctly apply project_id through PQL.

• Improved work item property creation and type association for governed workspaces.

• Improved work item type resolution to use workspace-level types when required.

• Archive operations now return the archived work item status.

• Improved PQL error handling by returning the invalid filter reference for correction.

• Added consistent pagination metadata across actions supporting cursors.

Projects, Cycles & Modules

• Bounded project list responses by default with cursor pagination.

• Continued use of lightweight endpoints for projects, cycles, modules, and workspace members.

• Fixed cycle archive to avoid unnecessary updates after a cycle has already ended.

• Added missing project feature flags and corrected is_time_tracking_enabled handling.

Tooling & Infrastructure

• Added shared toolkit modules for action definitions, runtime validation, pagination, governance, and response transformations.

• Pinned tool ordering to keep client prompt caches stable.

• Moved non-tool helpers out of the tool discovery path.

Fixes

Validation & Serialization

• Fixed unsupported action parameters being silently accepted and dropped.

• Fixed invalid enum values being silently ignored.

• Fixed malformed property options JSON being accepted without options.

• Fixed missing pagination envelopes being incorrectly treated as the last page.

• Fixed workspace property defaults incorrectly returning is_active: false.

Reachability

• Added missing project feature flags: parallel_cycles, project_updates, and workflows.

• Corrected is_time_tracking_enabled to be handled by the appropriate project update action.

Compatibility

• Existing retired tool names and parameter spellings continue to work.

• Tool results remain unchanged except for archive operations, which now return an explicit status object.

• project list is now paginated by default; callers should follow next_cursor or provide per_page.

v0.3.0-rc1

What's Changed

• [PAI-1700] feat: consolidate the tool surface to one action-dispatch tool per resource by @akhil-vamshi-konam in #199

Full Changelog: v0.2.11...v0.3.0-rc1

v0.2.11

Features

Customers

• Added customer management tools, including:

  • Customer CRUD operations

  • Customer property management

  • Customer property value management

  • Customer request management

  • Customer work item linking and unlinking

Releases

• Added release management tools, including:

  • Release CRUD operations

  • Release tag management

  • Release label management

  • Release work item management

  • Release changelog management

Improvements

Work Items

• list_work_items and list_archived_work_items now correctly honor sparse field selections, returning only the requested fields.

• Improved assignee and label management compatibility across Plane API versions by handling both object- and ID-based response formats.

Fixes

Work Items

• Fixed sparse field serialization where the fields parameter was accepted but ignored in list responses.

• Fixed manage_work_item_assignee and manage_work_item_label failing on API versions that return assignees and labels as plain ID strings instead of objects.

Workspace

• Fixed WorkspaceFeature updates to support partial (PATCH) requests by making feature fields optional, allowing callers to update only the specified features.

Full Changelog: v0.2.10...v0.2.11

v0.2.11-rc1

What's Changed

• feat: add customer tools by @akhil-vamshi-konam in #177
• feat: add release management tools by @akhil-vamshi-konam in #181
• fix: honor sparse fieldsets in work item lists and harden assignee/label read-backs by @akhil-vamshi-konam in #182
• chore: bump version from 0.2.10 to 0.2.11 by @akhil-vamshi-konam in #186

Full Changelog: v0.2.10...v0.2.11-rc1

v2.5.0-phoenix-mcp-487787a

What's Changed

• chore(deps): bump cryptography from 46.0.7 to 48.0.1 by @dependabot[bot] in #154
• chore(deps): bump starlette from 0.52.1 to 1.3.1 by @dependabot[bot] in #153
• fix: correct OAuth redirect allowlist by @akhil-vamshi-konam in #164
• feat: replace work item relations with dedicated dependency and custom relation tools by @akhil-vamshi-konam in #148
• chore: add ChatGPT OAuth connector redirect URIs to OAuth allowlist by @akhil-vamshi-konam in #165
• perf: use lite endpoints for project/cycle/module lists to fix large-workspace timeouts by @akhil-vamshi-konam in #162
• feat: load extra OAuth redirect URIs from env by @akhil-vamshi-konam in #166

Full Changelog: v0.2.9...v2.5.0-phoenix-mcp-487787a

v0.2.10

Features

Roles

• Added workspace/project role tools:

  • list_roles — list role definitions; filter by namespace (workspace or project), cursor-paginated

  • retrieve_role — fetch a single role definition by id

Initiatives

• Added initiative project management tools:

  • list_initiative_projects — list projects linked to an initiative

  • manage_initiative_projects — add or remove project links for an initiative

Work Item Relations

• work_item_relation_definitions (CRUD for workspace relation definitions)

• work_item_dependencies (manage the six built-in dependency types)

• work_item_custom_relations (manage definition-based custom relations)

Improvements

Workspace & Project Members

• get_workspace_members and get_project_members now use lightweight, cursor-paginated endpoints, improving performance and avoiding timeouts in large workspaces.

• Added member filters: first_name, last_name, email, display_name, role_slug, is_active, and is_bot.

• Member results now include role, role_slug, is_active, and is_bot.

Projects, Cycles & Modules

• list_projects, list_cycles, and list_modules now use lightweight, cursor-paginated endpoints, improving performance and avoiding timeouts in large workspaces.

OAuth Authentication

• Redirect URI allowlist is now configurable at runtime via the
  PLANE_OAUTH_ALLOWED_REDIRECT_URIS environment variable appended to the built-in defaults.

Logging

• Added workspace_slug and tool names to logs.

• Added LOG_USER_INFO (default: false) to optionally include user display names while keeping PII logging disabled by default.

Fixes

OAuth Authentication

• Fixed OAuth redirect URI validation for supported MCP clients.

• Updated the OAuth redirect allowlist for Chatgpt connectors, Cursor, VS Code, and Antigravity, resolving authentication failures caused by redirect URI mismatches.

Full Changelog: v0.2.9...v0.2.10

v2.5.0-phoenix-845a621

What's Changed

• refactor: replace dedicated epic tools with work-item-type-based approach and add server instructions by @akhil-vamshi-konam in #149
• feat: add work item attachment tools by @akhil-vamshi-konam in #147
• chore: consolidate add/remove and archive/unarchive tool pairs by @akhil-vamshi-konam in #150

Full Changelog: v2.5.0-phoenix-3d54d1a...v2.5.0-phoenix-845a621

v0.2.9

🚀 Features

Work Item Attachments

• Added attachment management tools:

  • list_work_item_attachments

  • upload_work_item_attachment_from_url with built-in SSRF protection

  • get_work_item_attachment_download_url

  • delete_work_item_attachment

  • read_work_item_attachment to read supported image and text attachments directly within MCP

Epics & Initiatives

• Updated Epic management to use regular work items with the Epic type

• Added resolve_work_item_type to automatically resolve or create work item types

• Added import_work_item_types_to_project for bulk type imports

• Added Initiative fallback guidance when the workspace feature is disabled

• Improved MCP instructions around Epic workflows

Projects

• Added project visibility management (public/private)

• Added project archive and unarchive support

• Added estimate scheme management, including:

  • Create, update, and delete estimate schemes

  • Create, update, and delete estimate point values

Work Items

• Added workspace-wide analytics with count_work_items

• Added PQL-based work item listing

• Added PQL filtering, sparse field selection, and per_page/cursor pagination to list_work_items

• Added custom property value management

• Added estimate assignment support

• Added archived work item management

• Added intake (triage) workflows to accept, decline, snooze, mark duplicates, or reset intake items

Pages

• Added workspace and project page listing

• Added page linking support for work items

Authentication & OAuth

• Added OAuth support for the Claude.ai web client

✨ Improvements

Tool Consolidation

• Reduced LLM ambiguity by consolidating multiple add/remove and archive/unarchive operations into unified tools.

Entity Management Consistency

• Updated cycle, module, and milestone tools to consistently use work_item_ids instead of issue_ids when managing associated work items.

Performance Optimizations

• Optimized custom property discovery using faster workspace-level lookups.

• Added user_id to request logs for improved traceability.

Documentation Improvements

• Clarified list_work_items field documentation by documenting description_html and noting that omitted or misnamed sparse fields return null instead of appearing as missing values.

🏗 Infrastructure

Deployment Improvements

• Added support for configurable MCP subpath deployments using MCP_PATH_PREFIX.

• Added AWS Secrets Manager support for Redis authentication in self-hosted deployments.

Dependency Updates

• Upgraded FastMCP to v3.2.0.

• Updated py-key-value.

• Added compatibility constraints for fakeredis.

🐛 Fixes

Authentication Security

• Fixed API key validation in PlaneHeaderAuthProvider.

• API keys are now validated against the Plane API instead of accepting any non-empty value.

• Improved validation requirements for authentication headers.

Work Item Descriptions

• Fixed create_work_item and update_work_item so plain-text descriptions are now correctly persisted by wrapping description_stripped into description_html instead of silently dropping the content.

Dependency Compatibility

• Pinned fakeredis < 2.35.0 to prevent pydocket startup failures caused by upstream breaking changes.

OAuth

• Disabled CIMD by default.

• Improved internal/external URL resolution handling across deployment configurations.