Plan MCP endpoint and tools

You can find information about Plan MCP tools and explore the available tools for managing work items, agile entities, and planning data.

Plan MCP endpoint

You can use the following endpoint to connect to the Plan MCP server:
https://<loop_hostname>/plan/mcp

MCP tools available in Plan

Tools Description Input Output
plan_deleteWorkitem Deletes an existing work item from the specified Plan application. applicationName, workItemId, teamspaceId Confirmation that the work item was successfully deleted.
plan_fetchWorkitem Retrieves detailed information for a specific work item by its ID. workItemId, teamspaceId, applicationName A record containing all available details for the specified work item.
plan_getAgileApprovals Retrieves a list of existing Agile approval records from a Plan application. applicationName, teamspaceId A list of approval records.
plan_getAgileReleases Retrieves a list of existing Agile Releases from a Plan application. applicationName, teamspaceId A list of Agile releases.
plan_getAgileSprints Retrieves a list of existing Agile Sprints from a Plan application. applicationName, teamspaceId A list of Agile sprints.
plan_getAgileWorkitems Retrieves Agile work items, supporting sprint and release filtering. applicationName, teamspaceId, optional filters A list of Agile work items matching the filters.
plan_getAvailableAgileWorkItemTypes Retrieves a list of existing Agile work item Types for a specific project. applicationName, teamspaceId, project A list of Agile work item types.
plan_getDevopsPlanApplications Retrieves all DevOps Plan applications available to the current user. None A list of accessible Plan applications, including name and teamspaceId.
plan_getProjectsInAgileApplication Retrieves all projects from a specified Plan application. applicationName, teamspaceId Project details, including ID, name, and description.
plan_getWorkItemMetaData Retrieves read-only Work Item Metadata (schema and field definitions). applicationName, teamspaceId Work Item Metadata schema (field names, types, allowed values, etc.).
plan_getWorkItemStatesAndStateTransitions Retrieves all available state transitions for the work item in the specified Plan application. applicationName, teamspaceId Detailed transition information (Action name, Destination state, Source states).
plan_addChildToParentWorkitem Adds/links a child work item to a parent work item. applicationName, parentWorkItemId, childWorkItemId, teamspaceId Confirmation of successful linking.
plan_addCommentToWorkitem Adds a comment to a work item. applicationName, workItemId, comment, teamspaceId Confirmation that the comment was added.
plan_addSubscriberToWorkitem Adds a subscriber to a work item. applicationName, workItemId, username, teamspaceId Confirmation that the user was added as a subscriber.
plan_assignOwnerToWorkitem Assigns or reassigns an owner to a work item. applicationName, workItemId, owner, teamspaceId Confirmation that the owner was successfully assigned.
plan_changeResolutionOfWorkitem Changes the Resolution field of a work item. applicationName, workItemId, resolution, teamspaceId

Confirmation that the resolution was changed.
plan_changeStateOfWorkitem Changes or sets the State field of a work item. applicationName, workItemId, state, teamspaceId

Confirmation that the state was changed.
plan_createAgileWorkitem Creates a new Agile work item. applicationName, title, type, project, teamspaceId

Details of the newly created work item.
plan_modifyAgileWorkitem Modifies an existing Agile work item. applicationName, workItemId, teamspaceId

Confirmation that the work item was successfully modified.
plan_removeSubscriberFromWorkitem Removes a subscriber from a work item. applicationName, workItemId, username, teamspaceId

Confirmation that the user was removed as a subscriber.
plan_setPlannedReleaseOfWorkitem Sets the PlannedRelease field of a work item. applicationName, workItemId, plannedRelease, teamspaceId

Confirmation that the planned release was set.
plan_setSprintForWorkitem Sets the Sprint field of a work item. applicationName, workItemId, sprint, teamspaceId

Confirmation that the sprint was set.
plan_setStoryPointsForWorkitem Sets the StoryPoints field of a work item. applicationName, workItemId, storyPoints, teamspaceId

Confirmation that the story points were set.
plan_setWorkitemStartAndEndDates Sets both StartDate and EndDate fields of a work item. applicationName, workItemId, startDate, endDate, teamspaceId

Confirmation that the start and end dates were set.
plan_addComponentToProject Adds links a Component to an existing Agile project. applicationName, teamspaceId, project, component

Confirmation that the component was added to the project.
plan_addReleaseToProject Adds links or associates an existing Release to an existing Agile project. applicationName, teamspaceId, project, releaseName

Confirmation that the release was associated with the project.
plan_addSprintToProject Adds links or associates an existing Sprint to an existing Agile project. applicationName, teamspaceId, project, sprintName

Confirmation that the sprint was associated with the project.
plan_addSprintToRelease Adds links or associates an existing Sprint to an existing Agile Release. applicationName, teamspaceId, releaseIdentifier, sprintName

Confirmation that the sprint was associated with the release.
plan_addWorkItemTypeToProject Adds or links a work item type to an existing Agile project. applicationName, teamspaceId, project, workItemType

Confirmation that the work item type was added to the project.
plan_createAgileProject Creates a new Agile project in the specified Plan application. applicationName, teamspaceId, projectName

Details of the newly created project.
plan_createAgileRelease Creates a new Agile Release in the specified Plan application. applicationName, teamspaceId, releaseName

Details of the newly created release.
plan_createAgileSprint Creates a new Agile Sprint in the specified Plan application. applicationName, teamspaceId, sprintName

Details of the newly created sprint.
plan_modifyAgileRelease Renames and/or updates an existing Agile Release. applicationName, teamspaceId, releaseIdentifier

Confirmation that the release was successfully modified.
plan_modifyAgileSprint Renames an existing Agile Sprint and/or updates its start and end dates within the specified Plan application. applicationName, teamspaceId, sprintIdentifier

Confirmation that the sprint was successfully modified.
plan_removeComponentFromProject Removes or unlinks or dissociates an existing Component from an existing Agile project within the specified Plan application. applicationName, teamspaceId, project, component

Confirmation that the component was removed from the project.
plan_removeReleaseFromProject Removes or unlinks or dissociates an existing Release from an existing Agile project within the specified Plan application. applicationName, teamspaceId, project, releaseName

Confirmation that the release was removed from the project.
plan_removeSprintFromProject Removes or unlinks or dissociates an existing Sprint from an existing Agile project within the specified Plan application. applicationName, teamspaceId, project, sprintName

Confirmation that the sprint was removed from the project.
plan_removeSprintFromRelease Removes or unlinks an existing Sprint from an existing Agile Release within the specified Plan application. applicationName, teamspaceId, releaseIdentifier, sprintName

Confirmation that the sprint was removed from the release.
plan_removeWorkItemTypeFromProject Removes or unlinks or dissociates an existing work item type from an existing Agile project within the specified Plan application. applicationName, teamspaceId, project, workItemType

Confirmation that the work item type was removed from the project.