Improve API Design Guidelines for MCP/Agent readiness

[rartych]

Problem description
As proposed in camaraproject/Governance#210 Commonalites are responsible for CAMARA API Design Guide enhancements with MCP-friendly documentation requirements (AI-readable descriptions, consistent parameter naming, actionable error messages)

Possible evolution

• Analyse best practices for generating MCP tools from OpenAPI specifications
• Propose improvements to guidelines documents

Alternative solution

Additional context
CAMARA + MCP Position Paper