2026-06-01 Commonalities MCP Enablement Program Minutes

2026-06-01 Commonalities MCP Enablement Program Minutes

Community Attendees:

@Rafal Artych @Leo Chely @Tanja De Groot (Nokia) @Pierre Close @Masaharu Hattori @Mark Cornall @Surajj Jaggernath Diego Preciado @Jan Friman

Community Attendees: @Ben Hepworth Klaus Reifenrath@Jesús Peña García-Oliva@pedro.diezgarcia@telefonica.com @diego.gonzalezmartinez @Sébastien Dewet Yannick Le Saout

LF Staff:

Agenda

The project's Antitrust Policy is linked from the LF and project websites. The policy is important when multiple companies, including potential industry competitors, are participating in meetings. Please review it, and if you have any questions, please contact your company’s legal counsel. Members of the LF may contact Andrew Updegrove at the firm Gesmer Updegrove LLP, which provides legal counsel to the LF.

  • API Design Guide Enhancements

  • Tool Definition Guide

  • Security & Consent Guidance

Minutes

API Design Guide Enhancements

Improve API Design Guidelines for MCP/Agent readiness · Issue #587 · camaraproject/Commonalities

  1. Good operationIds

  2. Decent Descriptions

@Ben Hepworth commented on observations that too verbose descriptions can be less effective for AI use.

@Rafal Artych indicated description templates can be used to have consistent operation description, for example:

description: |

When to use: {{ user asks to... }}

Differences: {{ Use instead of X when... }} (optional)

Side effects: {{ Action taken }} or "None"

Returns: {{ What’s in the response and how to use it }}

Requires: {{ Data needed, e.g. "customerId from context" }}

 

@Tanja De Groot (Nokia)asked about using Gherkin feature definitions for describing MCP tools.

 

  1. Examples

 

Tool Definition Guide

Preparation of CAMARA MCP Tool Definition Guide · Issue #588 · camaraproject/Commonalities

Interesting article from FastMCP author: https://jlowin.dev/blog/as-an-agent-the-new-user-story  

Can common ToolAnnotations be defined for CAMARA MCP tools?

see MCP specs:

interface ToolAnnotations {
  title?: string;
  readOnlyHint?: boolean;
  destructiveHint?: boolean;
  idempotentHint?: boolean;
  openWorldHint?: boolean;
}

 

Security & Consent Guidance

CAMARA Security, Privacy, and Consent guidance for MCP · Issue #347 · camaraproject/IdentityAndConsentManagement

 no updates

AOB

Yannick Le Saout asked about publishig Provider’s MCP implementations.

Action items