List all HacknPlan projects accessible with your API key. Returns { items, total, offset, limit, hasMore, index? }. In slim mode, includes index array of [id, name] pairs for all projects (not just current page).

Get details of a specific project

Create one or more projects (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Update one or more projects (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Delete one or more projects (array-based, DESTRUCTIVE). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Close one or more projects (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Reopen one or more closed projects (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Get project metrics (completion stats, etc.)

List all boards (sprints) for a project. Returns { items, total, offset, limit, hasMore, index? }. In slim mode, includes index array of [id, name] pairs for all boards (not just current page).

Get details of a specific board

Create one or more boards/sprints (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Update one or more boards (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Delete one or more boards (array-based, DESTRUCTIVE). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Close one or more boards/sprints (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Reopen one or more closed boards (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Get board metrics (burndown data, etc.)

List milestones for a project. Returns { items, total, offset, limit, hasMore }.

Get details of a specific milestone

Create one or more milestones (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Update one or more milestones (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Delete one or more milestones (array-based, DESTRUCTIVE). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Close one or more milestones (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Reopen one or more closed milestones (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

List work items with optional filters and pagination. Returns { items, total, offset, limit, index? }. In slim mode, includes index array of [id, name] pairs for all work items (not just current page).

Get detailed information about a specific work item

Create one or more work items (array-based). Supports name resolution for categoryId, importanceLevelId, and tagIds. Single-item and batch calls use the same interface. Returns unified response with items array, counts, per-item errors, and warnings.

Update one or more work items (array-based). Supports auto-create for tags: when string names are provided and the tag does not exist, it will be created automatically. Consolidates all setter operations (assignedUserIds, tagIds, parentStoryId, designElementId) into a single call. Returns unified response with items array, counts, per-item errors, and warnings for auto-created tags.

Add one or more dependencies between work items (array-based). Each item creates a dependency where the successor depends on the predecessor.

Remove one or more dependencies between work items (array-based). Each item removes a dependency relationship.

Assign a work item to the current user

List comments on a work item. Returns { items, total, offset, limit, hasMore }.

Add one or more comments to work items (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Update one or more comments (array-based). Each item updates a comment with new text.

Delete one or more comments (array-based). Each item removes a comment from a work item.

List design element types (e.g., Character, Item, Level). Returns { items, total, offset, limit, hasMore }.

Create one or more design element types (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

List design elements (game design documents). Returns { items, total, offset, limit, hasMore }.

Get details of a design element

Create one or more design elements (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Update one or more design elements (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Delete one or more design elements (array-based, DESTRUCTIVE). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

List available stages (workflow states) for a project. Returns { items, total, offset, limit, hasMore }.

Create one or more workflow stages (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Update one or more workflow stages (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

Delete one or more workflow stages (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

List available work item categories (Task, Bug, Feature, etc.). Returns { items, total, offset, limit, hasMore }.

Create one or more work item categories (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

List project tags. Returns { items, total, offset, limit, hasMore }.

Create one or more project tags (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, and per-item errors.

List importance/priority levels for a project. Returns { items, total, offset, limit, hasMore }.

List users in a project. Returns { items, total, offset, limit, hasMore }.

Get the current authenticated user information

Set the default project ID for this MCP server session. This overrides environment variables and .mcp.json config. Useful for switching between projects without restarting the server.

Set global output verbosity for all list operations. Controls whether list_projects, list_boards, and list_work_items return full or slim output by default.

Advanced search for work items with multiple filter criteria. Combines API filters with client-side filtering for comprehensive queries.

Stages work items for deletion and returns a confirmation request. No items are deleted until confirm_deletion is called with the confirmation token. Generates preview with warnings if deletion count exceeds cache capacity.

Delete one or more work items (array-based, requires confirmation). Stages items for deletion and returns a confirmation token. Call confirm_deletion with the token to execute the deletion. Items are stored in recovery cache before deletion for potential recovery.

Get a compressed summary of current sprint status with task counts by stage (highly optimized for token usage)

Get all child work items (subtasks) of a parent user story

Create a work item atomically with all related operations in a single transaction. v4.5+ supports name resolution.

Log work time for one or more work items (array-based). Single-item and batch calls use the same interface. Returns unified response with items array, counts, total hours, and per-item errors. Note: Does not include automatic time tracking - use log_work_session for that.

Get work items assigned to the current user. Returns { items, total }.

Get all incomplete work items for a project or board. Returns { items, total }.

Get TRUE backlog items - work items with NO board/sprint assignment. Returns { items, total }. NOTE: Items in closed sprints are NOT backlog - they are archived work.

Get overview of currently active (open) sprints with task counts. Returns { boards: [...], totalActiveSprints }.

Get full dependency tree for a work item (all predecessors and successors)

Get work items that are blocking this work item (predecessors that must complete first)

Clear cached data (metadata, work items, etc.). Use pattern to clear specific cache entries.

List available work item templates

Create work items from a template with variable substitution

Move a task to "In Progress" stage with optional comment. Supports name resolution for workItemId (e.g., "Implement shader" or 123). Auto-detects "In Progress" stage or uses stageId override.

Create a subtask linked to a parent user story in a single call. Wraps create_work_item + set_work_item_parent. Inherits board from parent if not specified. Supports name resolution for category, importance, and tags.

Complete a task in one call with optional time logging and comment. Atomically: marks task completed, optionally moves to completion stage, adds comment, and logs time. Supports name resolution for workItemId.

Pause work on a task. Accumulates time from current session and allows working on other tasks without corrupting time tracking.

Resume work on a paused task. Starts a new session without losing accumulated time from previous sessions.

Get current user's assigned tasks with aggregated statistics (by stage, by priority, total estimate). Returns slim work items for token efficiency. Supports both auto-fetch (all items) and manual pagination (offset/limit).

Analyze dependency graphs to identify blocking work items. Supports premium API + free-tier fallback (parses description markers). Returns items that are blocked by incomplete dependencies, optionally including transitive blockers. Can calculate critical path for a specific work item.

Get comprehensive sprint progress metrics including burndown chart, dependency graph, and hour tracking. Provides rich data for sprint visualization and analysis.

Delete a file attachment

Download a file attachment to local disk

Get attachment metadata and download URL

List file attachments for a work item with pagination

Set an image attachment as the work item card thumbnail (requires image file)

Upload a file attachment to a work item

Execute a staged deletion after user confirmation. Requires the confirmation token from batch_delete_work_items and acknowledged must be "DELETE" or "CONFIRM".

Cancel a staged deletion and release items from the confirmation queue. The items will not be deleted and the confirmation token will be invalidated.

Restore deleted work items from recovery cache. Creates new items (cannot restore original IDs). Handles double-recovery prevention, cross-project validation, and locked items.

View recovery cache statistics including capacity, entries by project/status, and age ranges. Useful for monitoring cache health.

Clear recovery cache entries. Requires acknowledged="CLEAR" for safety. Optionally filter by project. WARNING: This removes recovery capability for deleted items.

Export recovery cache to JSON file. Supports project-specific export. Useful for backup or migration.

Import recovery cache from JSON file. Supports merge (add to existing) or replace (clear then import) modes. Validates file format.