Plenar

MCP tools

These are the tools Plenar exposes over MCP. You don’t wire them up by hand — running plenar connect adds the Plenar MCP server to your editor (see Connect Claude Code), and from then on your agent knows the full catalog below and calls the right tool from your natural-language request. This reference is for when you want to know exactly what a tool does or the role it needs.

How tools work

Read-only tools return data immediately — no preview, no apply.

Write tools open a New Plan preview: they compute the change and hand back a preview you review, then commit with plenar_apply_changes. Nothing touches the Plan of Record until you apply.

Roles: a Planner token can do everything, including apply. A Contributor token can preview changes but not apply them. A few organization tools require Org Admin, and some are restricted to personal (user) tokens. Each tool below carries a role chip; see Roles and permissions for what each role can do.

Identity & discovery

plenar_whoami

Read-only

Returns your identity and project context, including the user ID used for reviewer assignments and the team-member ID used for task assignments.

plenar_help

Read-only

Discovers Plenar tools by free-text query or category, returning matching tools with descriptions and usage examples. Use it when you’re unsure which tool to call.

plenar_what_is_next

Read-only

Answers “what should I work on now?” with three buckets — starting today, completing today, and coming next — plus any decisions awaiting your review, ordered by the work they block.

plenar_get_project_context

Read-only

One-call session bootstrap: project info, Goals with health, your tasks, team members, and counts of pending changes and warnings. Call this at session start instead of many individual reads.

plenar_get_recent_activity

Read-only

Returns a chronological feed of recent project activity — schedule events, task updates, and status changes. Defaults to the last 24 hours; accepts a timestamp or duration like “7d”.

Tasks

plenar_get_my_tasks

Read-only

Lists your tasks for the project, grouped by status with scope, estimate, and dates.

plenar_start_task

Contributor or Planner

Marks a task In Progress and returns a suggested branch name plus a New Plan preview of the schedule impact. Apply the preview to commit it to the Plan of Record. Example: “Start working on PLEN-172.”

plenar_complete_task

Marks a task Done, returns a New Plan preview of the impact, and suggests your next task. Apply the preview to commit it to the Plan of Record. Example: “Mark PLEN-172 complete — it took about 3 days.”

plenar_bulk_complete

Marks up to 50 tasks Done in one batch, returning a single New Plan preview covering all of them. Supports per-task actual ship dates when backfilling historical work.

plenar_infer_task_completion

Read-only

Infers when a task likely finished from engineering signals (merged PRs, commits, linked artifacts), with a confidence label. Use it before completing a task whose work landed in the past so dates stay accurate.

plenar_update_estimate

Updates a task’s effort estimate and returns a New Plan preview of the schedule impact. Apply to commit it to the Plan of Record.

plenar_report_blocker

Flags a task as blocked, optionally naming the blocking task, and returns a New Plan preview plus alternative tasks you could pick up instead.

plenar_unblock_task

Resolves a blocker and sets the task back to In Progress or To Do, returning a New Plan preview of the impact.

plenar_log_effort

Records actual hours spent on a task (0–24 per day, defaulting to today). The more effort you log, the better Plenar calibrates future estimates.

plenar_move_task

Moves one or more tasks to a different Milestone, or removes them from their current Milestone. This does not change the schedule.

plenar_clone_task

Any authenticated user

Duplicates a task with all its content — spec, design, acceptance criteria, skills, estimate, and dependencies — as a draft you can edit before applying. The copy always starts as To Do.

Plans, goals & milestones

plenar_create_plan

Creates a full plan of Goals, Milestones, and Tasks at once and returns a New Plan preview. Apply the preview to commit it to the Plan of Record. Example: “Draft a plan with a goal to ship the analytics dashboard, broken into three milestones.”

plenar_add_tasks

Adds tasks incrementally to an existing plan and returns a New Plan preview. Dependencies can reference existing items by ID or title.

plenar_create_goal

Creates a Goal and returns a New Plan preview of the schedule impact. Apply to commit it to the Plan of Record.

plenar_create_milestone

Creates a Milestone, optionally under a Goal, and returns a New Plan preview of the schedule impact.

plenar_list_milestones

Read-only

Lists the project’s Milestones with key, name, parent Goal, Target date, ETA, and status. Useful for discovering where to place tasks.

plenar_delete_tasks

Deletes tasks by ID, returning a New Plan preview of the freed capacity and earlier finish dates before you commit. Removes dependency edges and unlinks artifacts; leaves Milestones and Goals intact.

plenar_delete_goals

Deletes Goals by ID, returning a New Plan preview of the impact. Milestones under them become unparented; tasks are not deleted.

plenar_delete_milestones

Deletes Milestones by ID, returning a New Plan preview of the impact. Tasks under them become unparented but are not deleted.

Dependencies

plenar_add_dependency

Adds a dependency between two tasks (the source blocks the target) and returns a New Plan preview of the impact.

plenar_remove_dependency

Removes a dependency between two tasks and returns a New Plan preview of the impact.

plenar_bulk_add_dependencies

Adds many dependencies in one call (a map of blocked task to its blockers) with a single New Plan preview.

plenar_bulk_remove_dependencies

Removes many dependencies in one call with a single New Plan preview.

plenar_list_blockers

Read-only

Lists what blocks the given tasks, as a map of each task to its blocker IDs.

plenar_list_blocking

Read-only

Lists what the given tasks block downstream, as a map of each task to the tasks it blocks.

Scheduling & preview

plenar_get_schedule_status

Read-only

Returns current schedule health: feasibility, Goal health, conflicts, warnings, and pending change count. Example: “How’s the schedule looking — are any goals off track?”

plenar_recompute

Planner

Forces a fresh schedule recompute. Use it when the schedule looks stale or after bulk changes made outside the preview flow.

plenar_set_project_settings

Planner

Updates project scheduling settings (such as capacity buffer and assignment mode) and returns a New Plan preview of the impact.

plenar_apply_changes

Planner

Applies a previewed New Plan to the Plan of Record and triggers a recompute. Contributors can preview but not apply. Example: “Apply the pending changes.”

plenar_get_pending_changes

Lists the queued changes in the current New Plan, grouped by entity, so you can inspect them before Apply or Discard.

plenar_discard_changes

Discards pending changes from the current New Plan — specific ones by ID, or all of them.

plenar_select_changes

Marks specific pending changes as selected (or unselected) for a partial apply. Follow with plenar_apply_selected.

plenar_apply_selected

Planner

Applies only the changes you selected to the Plan of Record, leaving the rest queued.

plenar_revert_change

Creates inverse changes that undo specific pending changes, swapping their old and new values back.

plenar_diff_schedules

Read-only

Compares two schedule versions — date shifts, reassignments, additions and removals, and Goal ETA changes. Useful for status reports and post-apply reviews.

Drafts

plenar_amend_draft

Accumulates edits to the current New Plan without recomputing — patching existing changes or adding new ones, including spec, design, and acceptance criteria on draft entities. Run plenar_preview_draft when ready to see the impact.

plenar_preview_draft

Computes the schedule impact of all accumulated draft changes. Run this after amending the draft, then Apply to commit.

plenar_get_draft_entities

Read-only

Inspects the current draft — draft entities not yet applied (with their content) and pending edits to existing entities.

Estimation & insight

plenar_get_velocity_context

Read-only

Returns velocity and calibration context for estimation: calibration factors, accuracy trends, and delivery metrics.

plenar_get_exemplars

Read-only

Finds completed tasks similar to a candidate task, so you can estimate by comparison with actual past durations.

plenar_get_burndown

Read-only

Returns progress stats for a Goal or Milestone: total/completed/remaining tasks, percent complete, velocity trend, and projected completion.

plenar_get_timeline_summary

Read-only

Returns a compact text schedule grouped by team member, showing task sequences with dates, the today marker, and deadlines. Designed to fit comfortably in agent context.

plenar_get_project_structure

Read-only

Returns the Goal → Milestone tree with names, IDs, and task counts. Use it to find where to place new tasks or understand the hierarchy.

Search & read

plenar_search

Read-only

Searches across Tasks, Goals, and Milestones with free text and structured field filters, returning grouped, paginated results.

plenar_get_entity

Read-only

Reads full details for one or more entities — all fields, content (spec, acceptance criteria, decisions, checklists), dependencies, and recent activity. Accepts UUIDs or human keys like PLEN-208.

plenar_get_context

Read-only

Returns the full context graph for an entity in one call — details, spec, design, acceptance criteria, dependencies, comments, activity, artifacts, and parents — replacing several separate reads.

plenar_export_plan

Read-only

Exports the Goal → Milestone → Task hierarchy as Markdown or CSV for sharing — Markdown for Slack, Notion, email, or PRs; CSV for spreadsheets.

plenar_get_task_activity

Read-only

Returns a task’s activity log — handoffs, status changes, and completion notes, newest first.

Specs, design docs & checklists

plenar_update_spec

Create or update the Problem statement (markdown) for a Goal, Milestone, Task, or the Project Poster. Supports updating several entities in one call.

plenar_update_design_doc

Create or update the Solution description (markdown) for a Goal, Milestone, Task, or the Project Poster. Supports updating several entities in one call.

plenar_update_body

Add or update a content block on a Goal, Milestone, or Task — markdown, checklist, spec, acceptance criteria, decision, or code. Use it to record specs, plans, and execution context directly on the item.

plenar_set_field

Set any field on one or more entities. Plan-affecting fields (estimate, assignment, Must/Nice scope, Target date) go through Apply/Discard and return a pending-changes handle; non-scheduling fields (title, description) apply immediately.

plenar_bulk_set_field

Update one field across up to 50 entities in a single batch and get one combined preview — handy for bulk scope, reassignment, milestone moves, or estimate changes. All entities must belong to the same project.

plenar_add_ac_item

Add Definition of Done items to a Goal, Milestone, or Task. Supports adding several at once.

plenar_remove_ac_item

Remove Definition of Done items by index. Supports removing several at once.

plenar_toggle_ac_item

Check or uncheck Definition of Done items. Supports toggling several at once.

plenar_update_ac_item

Edit the text of Definition of Done items. Supports updating several at once.

plenar_add_checklist_item

Add items to a generic checklist on a Goal, Milestone, or Task. Supports adding several at once.

plenar_remove_checklist_item

Remove checklist items by index. Supports removing several at once.

plenar_toggle_checklist_item

Check or uncheck checklist items. Supports toggling several at once.

plenar_update_checklist_item

Edit the text of checklist items. Supports updating several at once.

Decisions

plenar_create_decision

Create a decision record on a Goal, Milestone, or Task. Follow up by adding alternatives and submitting it for review. Supports creating several at once.

plenar_update_decision

Update a decision’s title, context, or rationale. Supports updating several at once.

plenar_delete_decision

Delete decisions by index; the remaining ones are re-indexed. Supports deleting several at once.

plenar_advance_decision

Move a decision to a new status (proposed, accepted, or superseded). Supports advancing several at once.

plenar_set_outcome

Set the outcome text on a decision. Supports setting several at once.

plenar_supersede_decision

Mark a decision as superseded, optionally linking the decision that replaces it. Supports superseding several at once.

plenar_add_alternative

Add alternatives to a decision, each with its own pros and cons. Supports adding several at once.

plenar_update_alternative

Edit the text, pros, or cons of a decision alternative. Supports updating several at once.

plenar_remove_alternative

Remove an alternative from a decision by index. Supports removing several at once.

plenar_add_reviewer

Add a reviewer to a decision; adding an existing reviewer is a no-op. Supports adding several at once.

plenar_remove_reviewer

Remove a reviewer from a decision. Supports removing several at once.

plenar_add_consulted

Add a consulted participant to a decision; adding an existing one is a no-op. Supports adding several at once.

plenar_remove_consulted

Remove a consulted participant from a decision. Supports removing several at once.

plenar_set_decision_deadline

Set or clear a decision’s deadline (pass null to clear). Supports updating several at once.

plenar_add_decision_note

Add a timestamped, attributed note to a decision. Supports adding several at once.

Knowledge base

plenar_create_concept

Create a knowledge-base concept — a standalone entry for cross-cutting topics (e.g. “Data Ingestion Pipeline”, “Auth System”). Optionally include overview and architecture markdown inline. Returns the concept ID for follow-up calls.

plenar_list_concepts

Read-only

List the project’s knowledge-base concepts. Returns metadata only by default; set include_content to also return each concept’s overview and architecture.

plenar_get_concept

Read-only

Get full details for one concept — overview, architecture, diagrams, decisions, and acceptance criteria — in a single call.

plenar_update_concept

Update a concept’s metadata and/or content in one call; provided fields are updated, omitted fields left unchanged.

plenar_archive_concept

Archive a concept, hiding it from the default list while preserving all content. It can be listed again with archived included.

plenar_delete_concept

Permanently delete a concept and all its content. This cannot be undone — prefer archiving.

Comments

plenar_add_comment

Add one or more comments to a Goal, Milestone, or Task. Bodies support markdown and are attributed to the agent.

plenar_bulk_add_comments

Add comments across multiple entities (up to 20) in one call — useful for session handoffs, status broadcasts, or cross-cutting updates.

plenar_list_comments

Read-only

List comments on a Goal, Milestone, or Task as a chronological, paginated list.

plenar_search_comments

Read-only

Full-text search across comments, returning matches with highlighted snippets. Filterable by entity and author.

plenar_edit_comment

Edit one or more comments. Only the author can edit their own comments.

plenar_delete_comment

Soft-delete one or more comments. Only the author or an admin can delete.

Project Poster

plenar_get_project_poster

Read-only

Get the full Project Poster: Problem, Solution, success criteria, risks, stakeholders, decisions, and references, with IDs for follow-up edits.

plenar_add_risk

Add a risk to the Project Poster risk registry; the risk score is computed automatically from likelihood × impact.

plenar_update_risk

Update a risk in the Project Poster risk registry.

plenar_remove_risk

Remove a risk from the Project Poster risk registry.

plenar_add_stakeholder

Add a stakeholder to the Project Poster stakeholder map.

plenar_update_stakeholder

Update a stakeholder in the Project Poster stakeholder map.

plenar_remove_stakeholder

Remove a stakeholder from the Project Poster stakeholder map.

plenar_add_reference

Add a reference link to the Project Poster.

plenar_update_reference

Update a reference link on the Project Poster.

plenar_remove_reference

Remove a reference link from the Project Poster.

Refinement pipeline

plenar_add_idea

Any project member

Capture a raw idea into a team’s refinement queue. Title is the only requirement; the idea starts unscheduled and gets its placement and estimate during refinement.

plenar_get_refinement_queue

Read-only

Read a team’s refinement queue — items grouped by stage with counts and the oldest unrefined item — so agents and the Refine tab can pick up work.

plenar_refine_item

Submit refinement for a captured idea: estimate, placement, and skills. The item auto-advances toward review once spec, at least one Definition of Done item, estimate, and placement are all present, and reports anything still missing.

plenar_approve_item

Approve a fully refined idea, promoting it to a scheduled Task. Goes through Apply/Discard and returns a pending-changes handle to commit.

plenar_reject_item

Reject a captured idea with a required reason (a terminal soft delete). The item stays queryable for audit.

plenar_send_back_item

Send a captured idea awaiting review back to refining with reviewer feedback, which the refiner sees on their next queue read.

plenar_delegate_idea

Transfer a captured idea from one team’s queue to another’s, preserving its refinement stage and clearing the reviewer for the new team.

Team

plenar_add_team_member

Planner

Adds a person to the project as a team member, looking them up by email and setting their role, weekly capacity, and skills. Returns a New Plan preview of the added capacity to apply.

plenar_remove_team_member

Planner

Removes a team member from the project, unassigning their work first. Returns a New Plan preview showing the impact of the reduced capacity.

plenar_update_member_skills

Planner

Sets the skills on team members, which changes who Plenar can assign work to. Returns a New Plan preview of the reassignment impact.

plenar_get_team_members

Lists the project’s team members with their skills, capacity, and current workload. Each member exposes two IDs — one for assigning work and one for naming them on decisions.

plenar_create_team

Planner

Creates a new team in your organization to hold members and skills; projects pick a team to plan against. Returns the new team’s ID for follow-up calls.

plenar_list_teams

Read-only

Lists every team in your organization with its name, icon, and color so follow-up calls can target a specific team.

plenar_update_team

Planner

Updates a team’s display fields — name, icon, and color. Does not affect the Plan of Record.

plenar_delete_team

Org Admin

Permanently deletes a team, cascading to its members, skill assignments, and time off; any project bound to it loses its team and must be reassigned before it can be planned.

plenar_update_team_member

Planner

Updates a team member’s role, seniority level, or weekly capacity. Capacity changes roll into the Plan of Record on the next recompute.

plenar_list_team_skills

Read-only

Lists a team’s skill catalog, returning each skill’s name, icon, description, and category. The catalog is shared across the team.

plenar_add_team_skill

Planner

Adds a skill to a team’s catalog, deduping names case-insensitively and auto-matching an icon you can override.

plenar_update_team_skill

Planner

Renames or recategorizes a skill in the team catalog, re-checking for name collisions and letting you override the icon.

plenar_delete_team_skill

Planner

Permanently removes a skill from the team catalog. Members who referenced it keep their assignments; the skill simply becomes orphaned.

Availability

plenar_add_time_off

Logs time off for yourself so capacity is adjusted automatically, choosing the type (PTO, sick, on-call, conference) that matches your intent. For a single day, set the start and end to the same date.

plenar_get_my_availability

Shows your upcoming time off and daily overrides for a date range, defaulting to the next 30 days. Use it to check what your calendar looks like or whether you are free.

plenar_cancel_time_off

Cancels a previously logged time-off entry by its ID or a single-day override by its date. Look it up with plenar_get_my_availability first to find the right entry.

plenar_update_time_off

Planner

Edits an existing multi-day time-off range. The change rolls into the Plan of Record on the next recompute.

plenar_upsert_availability_override

Planner

Sets a single-day availability override for a team member — for one-off changes like “working this Saturday” or “out today, sick” that don’t fit a multi-day range. Rolls into the Plan of Record on the next recompute.

plenar_delete_availability_override

Planner

Removes a single-day availability override, so the member’s default schedule applies again on that day. Rolls into the Plan of Record on the next recompute.

plenar_list_org_holidays

Read-only

Lists organization-level holidays, which apply to every member and reduce capacity.

plenar_create_org_holiday

Org Admin

Adds an organization-level holiday that applies to every member and reduces capacity, or a working-day override to make an otherwise non-working day count as working.

plenar_update_org_holiday

Org Admin

Edits an organization-level holiday’s name, date, or working-day flag. Affects every member and rolls into the Plan of Record on the next recompute.

plenar_delete_org_holiday

Org Admin

Removes an organization-level holiday, returning capacity to default for that day across the whole organization.

Projects

plenar_create_project

Planner

Creates a new, empty project in your organization, ready for planning.

plenar_list_projects

Read-only

Lists every project you can access, along with your pinned default if you have one. Call it on cold start to learn which project to assume by default.

plenar_resolve_project

Read-only

Fuzzy-matches a free-text project hint (name, key, or partial match) to the projects you can access, returning ranked candidates with match scores. Use it when someone references a project by name in conversation.

plenar_set_default_project

Read-only user token only

Pins a default project for the current user that persists across sessions, so agents don’t have to ask which project to use. Pass null to clear it; not available on org-key tokens.

plenar_provision_project

Planner

Creates a project end-to-end in one call — sets up the project, optionally a team, adds you as a member, sets the timezone, and pins it as default. Leaves the backlog empty so you can populate it next.

plenar_provision_project_from_brief

Planner

Creates a new project and structures it with Goals, Milestones, and Tasks in a single call — the headline tool for “set up a project for X.” Returns a New Plan preview you apply separately to commit.

plenar_create_sample_project

Planner

Creates a fully populated sample project from the demo template — Goals, Milestones, Tasks, dependencies, team members, and time off — as an onboarding seed or a reliable fallback.

plenar_archive_project

Planner

Archives a project by cancelling it, removing it from active views while preserving its data.

plenar_update_project

Planner

Updates a project’s display fields (name, description, key, icon, color) and start date. Run a recompute afterward to roll a start-date change into the Plan of Record.

plenar_update_project_timezone

Planner

Changes a project’s timezone, which sets the canonical “today” the whole team sees as overdue or slipped. Run a recompute afterward so dates pick up the new timezone.

Organization

plenar_list_org_members

Lists every user with organization-level membership, returning their ID, email, name, and role. This is org membership, not team membership.

plenar_invite_user

Org Admin user token only

Invites a user into your organization by email; they accept via the dashboard. Admins can invite Planners or Viewers, and only the Owner can invite an Admin.

plenar_list_invitations

Lists all invitations in your organization — pending, accepted, expired, and revoked — with email, role, status, and expiry so follow-up calls can target them.

plenar_revoke_invitation

Revokes a pending invitation so its accept link stops working immediately. Already-accepted invitations must be removed via the dashboard instead.

Artifacts

plenar_link_artifact

Links an artifact — a PR, doc, design, or test output — to a Task or project, returning a dashboard link to the linked entity.