targetprocess-mcp-server

Exposes CRUD operations for Targetprocess entities (epics, features, bugs, tasks, user stories) through MCP tool bindings that map directly to Targetprocess REST API endpoints. Implements a schema-based function registry where each entity type has corresponding create, read, update, delete tools with typed parameters validated against Targetprocess data models. The MCP server translates tool calls into authenticated HTTP requests to Targetprocess cloud or on-premise instances.

Implements semantic and structured search across Targetprocess entities using the MCP server's query tool, which translates filter expressions into Targetprocess API query syntax (OData-style or native filters). Supports filtering by entity type, status, priority, assignee, custom fields, date ranges, and text search. Returns paginated result sets with configurable field projection to reduce payload size and improve performance.

Provides MCP tools to retrieve hierarchical project structure, portfolio metadata, and team/resource information from Targetprocess. Fetches project lists, project details (including custom fields, workflows, team members), and portfolio-level aggregations. Caches project metadata to reduce API calls for frequently accessed context, implementing a simple in-memory cache with configurable TTL to balance freshness and performance.

Enforces valid state transitions for Targetprocess entities by validating workflow rules before allowing mutations. Retrieves workflow definitions from Targetprocess (valid state transitions, required fields for each state) and applies them as constraints on update operations. Prevents invalid state changes (e.g., moving a task directly from 'Open' to 'Closed' if workflow requires intermediate 'In Progress' state) and returns detailed error messages explaining why a transition is invalid.

Handles serialization and deserialization of Targetprocess custom fields (user-defined fields with custom data types) into JSON-compatible formats for MCP tool parameters. Maps custom field types (dropdowns, multi-select, date pickers, rich text, etc.) to appropriate JSON representations and validates input values against field constraints (allowed values, format requirements). Automatically converts between Targetprocess internal field IDs and human-readable field names for improved LLM usability.

Provides MCP tools for batch operations (create, update, or delete multiple work items in a single tool call) with partial failure handling and error recovery. Implements transactional semantics where possible (e.g., all-or-nothing for related items) and graceful degradation for partial failures (e.g., 8 of 10 items created successfully). Returns detailed error reports per item, allowing LLMs to understand which operations succeeded and which failed, and optionally retry failed items.

Exposes Targetprocess audit logs and change history through MCP tools, allowing LLMs to retrieve who changed what and when for any work item. Fetches change history with field-level granularity (old value, new value, timestamp, user who made the change) and supports filtering by date range, user, or change type. Enables audit-trail queries for compliance, debugging, or understanding the evolution of work items over time.