Capabilities
Match saved brief
Collections and publishing
How this capability is exposed
- Stable ID
ursy.art:match_saved_brief- Owning service
- URSY.art
- Runtime
- See the source declaration
Capability declarations describe what the service exposes. They are not a guarantee of availability or permission to execute an operation.
Accepted contract
{
"id": "ursy.art:match_saved_brief",
"name": "Match saved brief",
"description": "Collections and publishing",
"operation": "match_saved_brief",
"canonical_url": "https://ursy.art/wp-json/ursy-art/v1/tools/match_saved_brief",
"read_only": true,
"auth_required": true,
"mcp_public": false,
"input_schema": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "string",
"pattern": "^[1-9][0-9]*$"
}
]
}
},
"required": [
"id"
],
"additionalProperties": false
},
"output_schema": {
"$ref": "#/$defs/SearchResult",
"$defs": {
"SearchResult": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/Artwork"
},
"maxItems": 100
},
"total": {
"type": "integer",
"minimum": 0
},
"page": {
"type": "integer",
"minimum": 1
},
"pages": {
"type": "integer",
"minimum": 0
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"release": {
"type": "string"
},
"image_release": {
"type": "string"
},
"availability": {
"type": "string"
}
},
"required": [
"items",
"total",
"page",
"pages",
"limit",
"release"
],
"additionalProperties": true
},
"Artwork": {
"type": "object",
"properties": {
"schema_version": {
"type": "integer",
"minimum": 1
},
"id": {
"type": "string"
},
"source": {
"type": "string"
},
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"title": {
"type": "string"
},
"artist": {
"type": "string"
},
"artist_display": {
"type": "string"
},
"artist_id": {
"type": "string"
},
"creators": {
"type": "array",
"items": {
"$ref": "#/$defs/Creator"
}
},
"date": {
"type": "string"
},
"date_start": {
"type": [
"integer",
"null"
]
},
"date_end": {
"type": [
"integer",
"null"
]
},
"medium": {
"type": "string"
},
"dimensions": {
"type": "string"
},
"culture": {
"type": "string"
},
"department": {
"type": "string"
},
"kind": {
"type": "string"
},
"credit": {
"type": "string"
},
"description": {
"type": "string"
},
"description_license": {
"type": [
"string",
"null"
]
},
"subjects": {
"type": "array",
"items": {
"type": "string"
}
},
"accession": {
"type": "string"
},
"alt": {
"type": "string"
},
"width": {
"type": "integer",
"minimum": 0
},
"height": {
"type": "integer",
"minimum": 0
},
"orientation": {
"type": "string"
},
"images": {
"type": "array",
"items": {
"$ref": "#/$defs/Image"
}
},
"package": {
"anyOf": [
{
"$ref": "#/$defs/Package"
},
{
"type": "null"
}
]
},
"palette": {
"type": "array",
"items": {
"$ref": "#/$defs/PaletteColor"
}
},
"image_license": {
"type": [
"string",
"null"
]
},
"metadata_license": {
"type": "string"
},
"reuse": {
"type": "string"
},
"source_record_sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"record_sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"retrieved_at": {
"type": "string"
},
"source_modified": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"artist_url": {
"type": "string"
},
"analysis": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"embedding": {
"type": "string"
},
"ocr": {
"type": "string"
},
"palette": {
"type": "string"
},
"dhash": {
"type": "string"
}
},
"required": [],
"additionalProperties": true
},
"dhash": {
"type": "string"
},
"download_available": {
"type": "boolean"
},
"catalogue_only": {
"type": "boolean"
},
"source_has_image": {
"type": [
"boolean",
"null"
]
},
"source_image_eligible": {
"type": "boolean"
},
"source_image": {
"anyOf": [
{
"$ref": "#/$defs/SourcePreview"
},
{
"type": "null"
}
]
},
"source_rights_statement": {
"type": [
"string",
"null"
]
},
"catalogue_observation": {
"$ref": "#/$defs/Observation"
},
"similarity": {
"type": "number"
},
"color_distance": {
"type": "number"
}
},
"required": [
"id",
"title",
"artist",
"source",
"source_url",
"images"
],
"additionalProperties": true
},
"Creator": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"role": {
"type": [
"string",
"null"
]
},
"display": {
"type": [
"string",
"null"
]
},
"born": {
"type": [
"string",
"null"
]
},
"died": {
"type": [
"string",
"null"
]
},
"qualifier": {
"type": [
"string",
"null"
]
},
"wikidata": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name"
],
"additionalProperties": true
},
"Image": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"source_width": {
"type": "integer",
"minimum": 1
},
"source_height": {
"type": "integer",
"minimum": 1
},
"source_sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"variants": {
"type": "array",
"items": {
"$ref": "#/$defs/Variant"
}
}
},
"required": [
"id",
"source_width",
"source_height",
"source_sha256",
"variants"
],
"additionalProperties": true
},
"Variant": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"width": {
"type": "integer",
"minimum": 1
},
"height": {
"type": "integer",
"minimum": 1
},
"bytes": {
"type": "integer",
"minimum": 0
},
"mime": {
"type": "string"
},
"path": {
"type": "string"
},
"url": {
"type": "string"
},
"sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"parent_sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"metadata_schema": {
"type": "string"
},
"transform": {
"type": "object",
"properties": {
"fit": {
"type": "string"
},
"max_edge": {
"type": "integer",
"minimum": 1
},
"upscaled": {
"type": "boolean"
}
},
"required": [
"fit",
"max_edge",
"upscaled"
],
"additionalProperties": true
}
},
"required": [
"name",
"width",
"height",
"mime",
"url",
"sha256"
],
"additionalProperties": true
},
"Package": {
"type": "object",
"properties": {
"bytes": {
"type": "integer",
"minimum": 0
},
"path": {
"type": "string"
},
"sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"url": {
"type": "string"
}
},
"required": [
"bytes",
"path",
"sha256",
"url"
],
"additionalProperties": true
},
"PaletteColor": {
"type": "object",
"properties": {
"hex": {
"type": "string",
"pattern": "^#[a-fA-F0-9]{6}$"
},
"weight": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"hex",
"weight"
],
"additionalProperties": true
},
"SourcePreview": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"delivery": {
"type": "string"
},
"license": {
"type": [
"string",
"null"
]
},
"provider": {
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": true
},
"Observation": {
"type": "object",
"properties": {
"release": {
"type": "string"
},
"source_record_sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"release",
"source_record_sha256",
"retrieved_at"
],
"additionalProperties": true
}
}
},
"service_id": "ursy-art",
"parent_id": "",
"summary": "Collections and publishing",
"source_url": "https://ursy.art/.well-known/ursy-capabilities.json",
"source_type": "capability_manifest",
"verified_at": "2026-10-14 06:33:47",
"revision": "bf05143eb494c3d05aa6f43c335c097f7d33de3de8a9ce8c2103a1b22d3cc737",
"type": "capabilities",
"source": {
"url": "https://ursy.art/.well-known/ursy-capabilities.json",
"type": "capability_manifest"
},
"last_verified_at": "2026-10-14 06:33:47",
"stale": false
}