Hyperterse — Agentic server framework.

Each app/resources/**/config.terse file defines one MCP resource surface. A resource folder can represent either:

a concrete resource (uri), or
a resource template (uri_template).

Full schema

Concrete resource
Resource template

app/resources/release-notes/config.terse

uri: memory://release-notes/latest
name: release-notes
title: Latest release notes
description: Markdown release notes for the current release.
mime_type: text/markdown
file: ./content/release-notes.md

app/resources/order-by-id/config.terse

uri_template: memory://orders/{id}
name: order-by-id
title: Order by ID
description: Order payload template resolved by id.
mime_type: application/json
text_template: '{"id":"{{ id }}","status":"pending"}'
arguments:
  id:
    description: Order identifier
    required: true
    completion: ["1001", "1002", "1003"]

Field reference

string

Concrete resource URI. Use for fixed resources read via resources/read.

Exactly one of uri or uri_template must be defined.

string

URI template (RFC 6570 style) for parameterized resources.

Exactly one of uri or uri_template must be defined.

string

Optional display name.Default: resource folder name (directory containing config.terse).

string

Optional human-friendly title.

string

Optional description surfaced in MCP resource metadata.

string

Optional MIME type override for returned content.

string

Inline concrete content for uri resources.

For concrete resources, define one of text or file.

string

File path for concrete uri resources.Paths are resolved relative to the config.terse directory when not absolute.

For concrete resources, define one of text or file.

string

Inline template content for uri_template resources.Supports interpolation placeholders like {{ id }}.

For template resources, define one of text_template or file_template.

string

File path template for uri_template resources.Supports interpolation placeholders like ./docs/{{ id }}.md.Paths are resolved relative to the config.terse directory when not absolute.

For template resources, define one of text_template or file_template.

object

Optional map of URI template argument metadata keyed by argument name.

Show argument field properties

string

Optional display title.

string

Optional argument description.

boolean

default:"false"

Whether callers are expected to provide this argument.

array[string]

Optional static completion values used by completion/complete for resource template references.

Validity rules

One of uri or uri_template is required.
uri + uri_template together is invalid.
For uri resources: one of text or file is required.
For uri_template resources: one of text_template or file_template is required.
Resource URIs must be unique across concrete resources.
URI templates must be unique across template resources.

Runtime mapping

Concrete resources appear in MCP resources/list.
Template resources appear in MCP resources/templates/list.
Both are resolved via MCP resources/read.
Template arguments.completion values are used by MCP completion/complete (ref/resource).
Resource updates on model reload emit MCP notifications (resources/list_changed, resources/updated).

JSON Schema

Editor validation: schema/resource.terse.schema.json. Associate with **/resources/**/config.terse. See Configuration schemas.

​Full schema

​Field reference

​Validity rules

​Runtime mapping

​JSON Schema

Full schema

Field reference

Validity rules

Runtime mapping

JSON Schema