A tool server for Apptio Target Process that provides MCP tools for searching, creating, updating, and inspecting Target Process entities
Server has 5 tools with complete schemas and descriptions. Naming follows verb_noun convention (search_, get_, create_, update_, inspect_). Descriptions are present but generic (avg 120 chars, below 194-char baseline). Schemas are well-structured with enums and type constraints. However, parameter descriptions lack actionable detail (e.g., 'where' filter lacks examples of preset filters despite mentioning them). Output schemas are not documented. Error handling is basic, no recovery guidance or actionable error messages. Missing tool annotations (readOnlyHint/destructiveHint). No pagination support despite search returning up to 1000 items.
Create a new Target Process entity
Get details of a specific Target Process entity
Inspect Target Process API structure and entity metadata
Search Target Process entities with powerful filtering capabilities and preset filters for common scenarios
Update an existing Target Process entity
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields (e.g., created entity ID for chaining). Violates pattern:tool requirement.
search_entities accepts 'take' up to 1000 items with no pagination support. Large result sets blow context windows. Missing limit enforcement and cursor/offset parameters per pattern:paginated-result.
Parameter descriptions lack actionable constraints. 'where' filter mentions preset filters (searchPresets.open, etc.) but does not explain syntax or provide examples. 'include' array lacks guidance on valid values. Violates pattern:tool-description.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2026-07-28+ | v2 |
Error handling returns raw McpError with generic messages ('Create entity failed: ...'). No recovery guidance, actionable constraints, or classification (retryable vs. fatal). Violates pattern:recovery-guide.
Tool annotations missing. create_entity and update_entity are destructive but lack destructiveHint. search_entities and get_entity are read-only but lack readOnlyHint. Violates current MCP spec (2026-07-28) tool annotation requirement.