Isto Intents holder descriptor
What an intent holder publishes about itself at /.well-known/isto-intents.json (registry chapter §2, v0.2 draft).
$id: https://istointents.org/schemas/0.2/holder-descriptor.schema.json
Fields#
| field | type | required | description |
|---|
specVersion | "0.2" | yes | |
type | "holder-descriptor" | yes | |
id | string (uri, pattern ^https://[^/]+/\.well-known/isto-intents\.json$) | yes | the descriptor's own URL |
created | common › timestamp | yes | |
updated | common › timestamp | | |
operator | operator | yes | |
servers | array of server | yes | |
registry | object | | |
jwksUri | string (uri, pattern ^https://) | | where the holder publishes its signing keys (spec §11) |
extensions | object | | |
Definitions#
| name | type | description |
|---|
operator | object | the organisation responsible for the servers |
server | serverFields | one intent server of the holder |
serverFields | object | the fields of one intent server |
operator
| field | type | required | description |
|---|
name | string | yes | |
url | string (uri, pattern ^https://) | yes | |
contact | string (uri, pattern ^(mailto:|https://)) | yes | a role address, not a person's |
country | common › country | yes | |
serverFields
| field | type | required | description |
|---|
url | string (uri, pattern ^https://) | yes | |
binding | "mcp" | yes | |
transport | "streamable-http" | yes | |
profiles | array of anyOf: "consent-link", string (pattern ^x-) | yes | |
specVersions | array of string (pattern ^\d+\.\d+$) | yes | |
categories | array of common › category | yes | |
countries | array of common › country | yes | |
languages | array of common › language | yes | |
title | string | | |
mcpRegistryName | string (pattern ^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$) | | the server's name in the MCP Registry |
deprecated | boolean | | |
successor | string (uri, pattern ^https://) | | |
Examples#
Full schema#
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://istointents.org/schemas/0.2/holder-descriptor.schema.json",
"title": "Isto Intents holder descriptor",
"description": "What an intent holder publishes about itself at /.well-known/isto-intents.json (registry chapter §2, v0.2 draft).",
"type": "object",
"required": [
"specVersion",
"type",
"id",
"created",
"operator",
"servers"
],
"properties": {
"specVersion": {
"const": "0.2"
},
"type": {
"const": "holder-descriptor"
},
"id": {
"type": "string",
"format": "uri",
"pattern": "^https://[^/]+/\\.well-known/isto-intents\\.json$",
"description": "the descriptor's own URL"
},
"created": {
"$ref": "https://istointents.org/schemas/0.1/common.schema.json#/$defs/timestamp"
},
"updated": {
"$ref": "https://istointents.org/schemas/0.1/common.schema.json#/$defs/timestamp"
},
"operator": {
"$ref": "#/$defs/operator"
},
"servers": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"$ref": "#/$defs/server"
}
},
"registry": {
"type": "object",
"required": [
"listing"
],
"properties": {
"listing": {
"enum": [
"requested",
"withdrawn"
],
"description": "requested asks the registry to list the host; withdrawn asks it to remove the entry"
},
"terms": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "URL of the registry terms the operator accepts"
}
},
"if": {
"properties": {
"listing": {
"const": "requested"
}
}
},
"then": {
"required": [
"terms"
]
},
"additionalProperties": false
},
"jwksUri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "where the holder publishes its signing keys (spec §11)"
},
"extensions": {
"type": "object",
"propertyNames": {
"pattern": "^(x-|https?://)"
}
}
},
"$defs": {
"operator": {
"type": "object",
"description": "the organisation responsible for the servers",
"required": [
"name",
"url",
"contact",
"country"
],
"properties": {
"name": {
"type": "string",
"minLength": 2,
"maxLength": 120
},
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"contact": {
"type": "string",
"format": "uri",
"pattern": "^(mailto:|https://)",
"description": "a role address, not a person's"
},
"country": {
"$ref": "https://istointents.org/schemas/0.1/common.schema.json#/$defs/country"
}
},
"additionalProperties": false
},
"server": {
"description": "one intent server of the holder",
"$ref": "#/$defs/serverFields",
"unevaluatedProperties": false
},
"serverFields": {
"type": "object",
"description": "the fields of one intent server",
"required": [
"url",
"binding",
"transport",
"profiles",
"specVersions",
"categories",
"countries",
"languages"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"binding": {
"const": "mcp"
},
"transport": {
"const": "streamable-http"
},
"profiles": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"anyOf": [
{
"const": "consent-link"
},
{
"type": "string",
"pattern": "^x-"
}
]
}
},
"specVersions": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^\\d+\\.\\d+$"
}
},
"categories": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"$ref": "https://istointents.org/schemas/0.1/common.schema.json#/$defs/category"
}
},
"countries": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"$ref": "https://istointents.org/schemas/0.1/common.schema.json#/$defs/country"
}
},
"languages": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"$ref": "https://istointents.org/schemas/0.1/common.schema.json#/$defs/language"
}
},
"title": {
"type": "string",
"maxLength": 120
},
"mcpRegistryName": {
"type": "string",
"pattern": "^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$",
"description": "the server's name in the MCP Registry"
},
"deprecated": {
"type": "boolean"
},
"successor": {
"type": "string",
"format": "uri",
"pattern": "^https://"
}
}
}
},
"additionalProperties": false
}
