McpMeta

Type-namespace marker for MCP (Model Context Protocol) request metadata.

Register an instance of this class in a RuntimeContext (via RuntimeContext or RuntimeContext) to have its entries automatically included as the meta field of every MCP McpSchema.CallToolRequest sent through McpTool.

Only objects registered under the McpMeta.class type key are extracted — other context objects (DI beans, configs, etc.) are never leaked into MCP meta.

Usage examples:

1) Via RuntimeContext:

`RuntimeContext rtCtx = RuntimeContext.builder()
.put(McpMeta.class, new McpMeta(Map.of("traceId", "abc-123")))
.build();
`

2) Merging multiple meta sources (later entries override earlier ones for the same key):

`McpMeta base = new McpMeta(Map.of("traceId", "abc-123"));
McpMeta extra = new McpMeta(Map.of("callbackUrl", "https://hook.example.com"));
McpMeta merged = McpMeta.merge(base, extra);
`