Join our Newsletter — 33% off our NHI Course

MCP Semantic Conventions

OpenTelemetry definitions for observing Model Context Protocol activity. They standardize client and server spans, propagation details, tool-aware attributes, and related metrics so MCP traffic can be correlated across systems. The goal is semantic continuity across the protocol boundary, not automatic visibility into every implementation or every tool execution.

Expanded Definition

MCP Semantic Conventions are the OpenTelemetry naming and attribute rules used to make Model Context Protocol activity measurable in a consistent way. They describe how client and server spans, message flow, tool invocation context, and related telemetry fields should be represented so different observability systems can interpret the same event chain. For security teams, the value is not just trace collection. It is the ability to preserve semantic continuity across the protocol boundary so MCP traffic can be correlated with upstream prompts, downstream tool calls, and policy enforcement points.

These conventions are still evolving in practice because MCP implementations vary widely and observability maturity is inconsistent across agent stacks. That means teams should treat the conventions as a shared telemetry vocabulary, not as a guarantee that every tool action, hidden chain-of-thought step, or external side effect will be visible. The most common misapplication is assuming semantic conventions provide full auditability, which occurs when teams confuse standardised trace labels with complete behavioural logging.

Examples and Use Cases

Implementing MCP Semantic Conventions rigorously often introduces instrumentation overhead and schema discipline, requiring organisations to weigh observability depth against the cost of consistent telemetry engineering.

  • Security monitoring teams can correlate a client span for an agent request with server spans that represent MCP tool selection and response handling, improving investigation quality when an agent behaves unexpectedly.
  • Platform engineers can use standardised attributes to distinguish tool discovery, tool invocation, and result propagation, which helps isolate latency and error patterns across agent workflows.
  • Governance teams can map MCP traffic to policy checkpoints and review whether tool access was initiated by an authorised OWASP Agentic AI Top 10 control surface, especially where external tools expose sensitive systems.
  • Incident responders can compare traces from multiple services to determine whether a failure originated in the agent, the mcp server, or a downstream API, which is more reliable than relying on application logs alone.
  • Compliance teams can use the same semantic fields to support evidence collection for access reviews, change reviews, and exception handling, particularly when tool execution crosses team boundaries.

Why It Matters for Security Teams

MCP Semantic Conventions matter because agentic systems often fail at the boundary between intent and execution. When telemetry is inconsistent, security teams lose the ability to reconstruct which tool was called, by whom or by what agent, with what context, and through which server path. That weakens detection, response, and governance. In an environment shaped by the OWASP Top 10 for Agentic Applications 2026, standardised telemetry becomes a control enabler because it supports investigation of indirect prompt injection, tool misuse, and excessive agent authority.

For NHI and agentic AI governance, the connection is practical: MCP traces can help show when a non-human identity or agent session exercised tool access that should have been constrained, reviewed, or short-lived. They do not replace PAM, policy enforcement, or secrets control, but they make those controls observable. Organisations typically encounter the operational value of MCP semantic conventions only after an agent incident, at which point trace consistency becomes operationally unavoidable to diagnose what actually happened.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

OWASP Agentic AI Top 10 and OWASP Non-Human Identity Top 10 address the attack and risk surface, while NIST AI RMF, NIST CSF 2.0 and NIST Zero Trust (SP 800-207) set the governance and control requirements practitioners need to meet.

Framework Control / Reference Relevance
OWASP Agentic AI Top 10 Agentic AI guidance covers tool-use risks that MCP traces help investigate.
NIST AI RMF AI RMF speaks to governance and measurement needs that semantic telemetry supports.
NIST CSF 2.0 DE.CM-1 Continuous monitoring requires usable telemetry across systems and workflows.
OWASP Non-Human Identity Top 10 NHI governance depends on traceability for non-human identities and their tool actions.
NIST Zero Trust (SP 800-207) 5.2 Zero Trust relies on continuous verification and observable request context.

Preserve request context in telemetry so policy decisions remain inspectable across trust boundaries.