A collection of MCP tools to access a CRM and ERP system for purchasing agents
Two tools with basic schemas and German descriptions. Naming follows verb conventions (search_, get_). Descriptions are present but brief (10-15 chars core action). Input schemas are explicit and typed with enums on get_orders, but output schemas are not documented in source. Error handling exists (required param validation) but lacks recovery guidance. Tool annotations (OpenWorldHintAnnotation) are present, which is positive. No pagination documented despite potential for order lists to grow large. Parameter descriptions are adequate but could better explain context (e.g., what 'kundenNummer' represents beyond 'customer number in CRM').
Ruft Bestellungen aus dem ERP-System ab
Sucht nach einem Kunden im CRM System
Output schemas not documented. Code shows tools return JSON via ToJSON() but the structure of returned Customer and OrderList objects is not visible in the MCP tool definition.
Descriptions are minimal (11-13 characters for core action). While present, they lack context about WHEN to use these tools and what business process they support. Expected baseline: 50-200 chars per Arcade production baselines.
get_orders returns a list but no pagination parameters (limit, offset, cursor) are present. If order lists grow beyond 50 items, response may blow context window. Tool description does not state result limits.
Error handling is basic: only validates required 'kundenNummer' param and returns generic error. No recovery guidance (e.g., 'If customer not found, try search_customer()'). No contextual error messages like 'Invalid status: got X, must be one of: waiting, offen, verschickt'.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 59 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 33 | - | v1 |
Hard-coded mock data in tools (Customer QAware GmbH, OrderList with fixed items). No indication of real backend integration or how actual CRM/ERP system is called. In production, this severely limits utility.