get_project_process_id
Retrieve the process ID for a specific project in Azure DevOps. Use to identify project processes, verify process details, or support process-related operations. Input the project ID or name to get formatted process information.
Instructions
Gets the process ID associated with a project.
Use this tool when you need to:
- Find out which process a project is using
- Get the process ID for use in other process-related operations
- Verify process information for a project
Args:
project: Project ID or project name
Returns:
Formatted information about the process including name and ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project | Yes |
Implementation Reference
- The MCP tool handler decorated with @mcp.tool(). It takes a project name or ID, calls the helper implementation, and returns formatted process information or error.@mcp.tool() def get_project_process_id(project: str) -> str: """ Gets the process ID associated with a project. Use this tool when you need to: - Find out which process a project is using - Get the process ID for use in other process-related operations - Verify process information for a project Args: project: Project ID or project name Returns: Formatted information about the process including name and ID """ try: return _get_project_process_id_impl(project) except Exception as e: return f"Error: {str(e)}"
- The core implementation that uses the Azure DevOps core client to fetch project details, extracts process template from capabilities, and formats the process ID and name.def _get_project_process_id_impl(project: str) -> str: """Implementation of project process ID retrieval.""" try: # Get project details with process information core_client = get_core_client() project_details = core_client.get_project( project, include_capabilities=True) process_template = project_details.capabilities.get( "processTemplate", {}) process_id = process_template.get("templateTypeId") process_name = process_template.get("templateName") if not process_id: return f"Could not determine process ID for project {project}." result = [f"# Process for Project: {project_details.name}"] result.append(f"Process Name: {process_name}") result.append(f"Process ID: {process_id}") return "\n".join(result) except Exception as e: return (f"Error retrieving process ID for project '{project}': " f"{str(e)}")
- Registration call within the tools __init__.py that invokes process.register_tools(mcp) to register the process tools including get_project_process_id.process.register_tools(mcp)