Skip to content

[docs] Document programmatic Resource static properties for MCP/OpenAPI schema authoring #1923

Description

@kylebernhardy

Follow-up from #1920 / PR #1921.

static properties (a Record<string, JsonSchemaFragment>) was introduced in #1167 as the canonical class-level metadata API. PR #1921 extends it so a programmatic Resource declaring a bare static properties literal (no table-backed attributes Array) now drives rich MCP tool inputSchemas, the OpenAPI document, and the harper://schema introspection resource — types, per-property descriptions, enum/format/const, arrays, and nested objects.

The HarperFast/documentation site should document this authoring path:

Needs a companion PR to HarperFast/documentation (see its AGENTS.md for versioning/mechanics).

Issue generated by kAIle (Claude Opus 4.8).

Metadata

Metadata

Assignees

Labels

area:mcpModel Context Protocol (MCP) server: protocol, profiles, stdio CLI

Type

Fields

Priority

P3

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions