URSY.DEVPART OF THE URSY NETWORKSign inBuild with URSY

Every contract sourcedEvery check datedGaps shown, never filledBuild with URSY

Capabilities

Get image provenance

Images and evidence

How this capability is exposed

Stable ID
ursy.art:get_image_provenance
Owning service
URSY.art
Runtime
See the source declaration
Open the owning interface ↗

Capability declarations describe what the service exposes. They are not a guarantee of availability or permission to execute an operation.

Accepted contract

REGISTRY JSON
{
    "id": "ursy.art:get_image_provenance",
    "name": "Get image provenance",
    "description": "Images and evidence",
    "operation": "get_image_provenance",
    "canonical_url": "https://ursy.art/wp-json/ursy-art/v1/tools/get_image_provenance",
    "read_only": true,
    "auth_required": false,
    "mcp_public": true,
    "input_schema": {
        "type": "object",
        "properties": {
            "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
            }
        },
        "required": [
            "id"
        ],
        "additionalProperties": false
    },
    "output_schema": {
        "$ref": "#/$defs/ImagePackage",
        "$defs": {
            "ImagePackage": {
                "type": "object",
                "properties": {
                    "artwork": {
                        "$ref": "#/$defs/Artwork"
                    },
                    "images": {
                        "type": "array",
                        "items": {
                            "$ref": "#/$defs/Image"
                        }
                    },
                    "package": {
                        "anyOf": [
                            {
                                "$ref": "#/$defs/Package"
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "credit_line": {
                        "type": "string"
                    },
                    "provenance": {
                        "$ref": "#/$defs/Provenance"
                    },
                    "sponsor": {
                        "$ref": "#/$defs/Sponsor"
                    }
                },
                "required": [
                    "artwork",
                    "images",
                    "package",
                    "credit_line",
                    "provenance"
                ],
                "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
            },
            "Provenance": {
                "type": "object",
                "properties": {
                    "source_url": {
                        "type": "string"
                    },
                    "record_hash": {
                        "type": "string",
                        "pattern": "^[a-fA-F0-9]{64}$"
                    },
                    "retrieved_at": {
                        "type": "string"
                    },
                    "evidence_class": {
                        "type": "string"
                    },
                    "source_record_sha256": {
                        "type": "string",
                        "pattern": "^[a-fA-F0-9]{64}$"
                    },
                    "record_sha256": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "catalogue_observation": {
                        "anyOf": [
                            {
                                "$ref": "#/$defs/Observation"
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "limitations": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "scope": {
                        "type": "string"
                    },
                    "files": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "image_id": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "url": {
                                    "type": "string"
                                },
                                "sha256": {
                                    "type": "string",
                                    "pattern": "^[a-fA-F0-9]{64}$"
                                },
                                "parent_sha256": {
                                    "type": "string",
                                    "pattern": "^[a-fA-F0-9]{64}$"
                                },
                                "width": {
                                    "type": "integer",
                                    "minimum": 1
                                },
                                "height": {
                                    "type": "integer",
                                    "minimum": 1
                                },
                                "bytes": {
                                    "type": "integer",
                                    "minimum": 0
                                }
                            },
                            "required": [],
                            "additionalProperties": true
                        }
                    }
                },
                "required": [
                    "source_url",
                    "record_hash",
                    "retrieved_at",
                    "evidence_class"
                ],
                "additionalProperties": true
            },
            "Sponsor": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "url": {
                        "type": "string"
                    },
                    "role": {
                        "type": "string"
                    },
                    "message": {
                        "type": "string"
                    },
                    "month": {
                        "type": "string"
                    },
                    "sponsored": {
                        "type": "boolean"
                    },
                    "disclosure": {
                        "type": "string"
                    },
                    "rel": {
                        "type": "string"
                    }
                },
                "required": [
                    "name"
                ],
                "additionalProperties": true
            }
        }
    },
    "service_id": "ursy-art",
    "parent_id": "",
    "summary": "Images and evidence",
    "source_url": "https://ursy.art/.well-known/ursy-capabilities.json",
    "source_type": "capability_manifest",
    "verified_at": "2026-10-14 03:03:54",
    "revision": "c9806c83c1aae7333b22ade32ff5fee1d4aaff3dfa9a849e5f136306d61e58b4",
    "type": "capabilities",
    "source": {
        "url": "https://ursy.art/.well-known/ursy-capabilities.json",
        "type": "capability_manifest"
    },
    "last_verified_at": "2026-10-14 03:03:54",
    "stale": false
}