Capabilities
Provenance Get
Get source, rights, methodology and accepted snapshot provenance. Financial reference/information data only. Not personalised financial advice, not an execution venue, and not a guarantee of a tradable price.
How this capability is exposed
- Stable ID
ursy.finance:provenance-get- Owning service
- URSY.finance
- 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.finance:provenance-get",
"mcp_tool": "get_provenance",
"description": "Get source, rights, methodology and accepted snapshot provenance. Financial reference/information data only. Not personalised financial advice, not an execution venue, and not a guarantee of a tradable price.",
"routes": [
{
"operation_id": "getProvenance",
"method": "GET",
"url": "https://ursy.finance/wp-json/ursy-finance/v2/provenance/{id}",
"rate_limit": {
"bucket": "metadata",
"requests_per_minute": 120
},
"mcp_rate_limit": {
"bucket": "mcp",
"requests_per_minute": 60
}
}
],
"input_schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Canonical instrument ID or an unambiguous registered alias."
},
"snapshot": {
"type": "string",
"pattern": "^snap_[a-f0-9]{32}$",
"maxLength": 37,
"description": "Immutable accepted snapshot. Omit to pin the latest accepted source snapshot."
}
},
"required": [
"id"
],
"additionalProperties": false
},
"output_schema": {
"type": "object",
"properties": {
"schema": {
"type": "string"
},
"instrument": {
"type": "object",
"properties": {
"schema": {
"const": "ursy.finance/instrument/v2"
},
"id": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"asset_class": {
"type": "string"
},
"country": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"venue": {
"type": [
"string",
"null"
]
},
"publisher": {
"type": [
"string",
"null"
]
},
"provider": {
"type": [
"string",
"null"
]
},
"series_id": {
"type": [
"string",
"null"
]
},
"unit": {
"type": [
"string",
"null"
]
},
"frequency": {
"type": [
"string",
"null"
]
},
"data_kind": {
"type": "string"
},
"source_id": {
"type": "string"
},
"canonical_url": {
"type": "string"
},
"methodology_url": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"identity_status": {
"type": "string"
},
"definition_history": {
"type": "object",
"properties": {
"schema": {
"const": "ursy.finance/definition-history/v2"
},
"status": {
"enum": [
"published_segments",
"specification_only",
"definition_changed_review_required",
"not_retained_in_snapshot",
"not_applicable"
]
},
"metadata_scope": {
"enum": [
"current_registry",
"accepted_snapshot",
"not_applicable"
]
},
"history_complete": {
"const": false
},
"publisher_definition": {
"type": [
"string",
"null"
]
},
"publisher_definition_sha256": {
"type": [
"string",
"null"
]
},
"evidence_url": {
"type": [
"string",
"null"
]
},
"evidence_location": {
"type": [
"string",
"null"
]
},
"date_convention": {
"type": "string"
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"effective_from": {
"type": [
"string",
"null"
]
},
"effective_to": {
"type": [
"string",
"null"
]
},
"effective_from_precision": {
"enum": [
"year",
"month",
null
]
},
"effective_to_precision": {
"enum": [
"year",
"month",
null
]
},
"effective_from_basis": {
"enum": [
"publisher",
"derived_from_adjacent_publisher_period",
"unknown"
]
},
"effective_to_basis": {
"enum": [
"publisher",
"derived_from_adjacent_publisher_period",
"unknown"
]
},
"description": {
"type": "string"
}
},
"required": [
"effective_from",
"effective_to",
"effective_from_precision",
"effective_to_precision",
"effective_from_basis",
"effective_to_basis",
"description"
]
}
}
},
"required": [
"schema",
"status",
"metadata_scope",
"history_complete",
"publisher_definition",
"publisher_definition_sha256",
"evidence_url",
"evidence_location",
"date_convention",
"segments"
]
}
},
"required": [
"schema",
"id",
"symbol",
"name",
"asset_class",
"country",
"currency",
"venue",
"publisher",
"provider",
"series_id",
"unit",
"frequency",
"data_kind",
"source_id",
"canonical_url",
"methodology_url",
"source_url",
"aliases",
"identity_status"
]
},
"source": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"publisher": {
"type": [
"string",
"null"
]
},
"provider": {
"type": [
"string",
"null"
]
},
"dataset": {
"type": "string"
},
"adapter": {
"type": "string"
},
"adapter_version": {
"type": "string"
},
"licence": {
"type": [
"string",
"null"
]
},
"licence_url": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"methodology_url": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string"
},
"redistribution_rights": {
"type": "string"
},
"api_allowed": {
"type": "boolean"
},
"history_allowed": {
"type": "boolean"
},
"bulk_download_allowed": {
"type": "boolean"
},
"human_display_allowed": {
"type": [
"boolean",
"null"
]
},
"attribution_required": {
"type": "boolean"
},
"last_reviewed": {
"type": "string"
},
"rights_scope": {
"type": "string"
},
"refresh_cadence": {
"type": "string"
},
"freshness_rules": {
"type": "object"
},
"live_definition": {
"type": "string"
}
},
"required": [
"source_id",
"publisher",
"provider",
"dataset",
"adapter",
"adapter_version",
"licence",
"licence_url",
"terms_url",
"url",
"methodology_url",
"attribution",
"redistribution_rights",
"api_allowed",
"history_allowed",
"bulk_download_allowed",
"human_display_allowed",
"attribution_required",
"last_reviewed",
"rights_scope",
"refresh_cadence",
"freshness_rules",
"live_definition"
]
},
"methodology": {
"type": "object",
"properties": {
"definition_history": {
"type": "object",
"properties": {
"schema": {
"const": "ursy.finance/definition-history/v2"
},
"status": {
"enum": [
"published_segments",
"specification_only",
"definition_changed_review_required",
"not_retained_in_snapshot",
"not_applicable"
]
},
"metadata_scope": {
"enum": [
"current_registry",
"accepted_snapshot",
"not_applicable"
]
},
"history_complete": {
"const": false
},
"publisher_definition": {
"type": [
"string",
"null"
]
},
"publisher_definition_sha256": {
"type": [
"string",
"null"
]
},
"evidence_url": {
"type": [
"string",
"null"
]
},
"evidence_location": {
"type": [
"string",
"null"
]
},
"date_convention": {
"type": "string"
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"effective_from": {
"type": [
"string",
"null"
]
},
"effective_to": {
"type": [
"string",
"null"
]
},
"effective_from_precision": {
"enum": [
"year",
"month",
null
]
},
"effective_to_precision": {
"enum": [
"year",
"month",
null
]
},
"effective_from_basis": {
"enum": [
"publisher",
"derived_from_adjacent_publisher_period",
"unknown"
]
},
"effective_to_basis": {
"enum": [
"publisher",
"derived_from_adjacent_publisher_period",
"unknown"
]
},
"description": {
"type": "string"
}
},
"required": [
"effective_from",
"effective_to",
"effective_from_precision",
"effective_to_precision",
"effective_from_basis",
"effective_to_basis",
"description"
]
}
}
},
"required": [
"schema",
"status",
"metadata_scope",
"history_complete",
"publisher_definition",
"publisher_definition_sha256",
"evidence_url",
"evidence_location",
"date_convention",
"segments"
]
}
}
},
"freshness_rules": {
"type": "object"
},
"refresh_cadence": {
"type": "string"
},
"revision_policy": {
"type": "string"
},
"source_health": {
"type": "object"
},
"integrity": {
"type": [
"object",
"null"
]
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"schema",
"instrument",
"source",
"methodology",
"freshness_rules",
"refresh_cadence",
"revision_policy",
"source_health",
"integrity",
"warnings"
]
},
"data_class": "reference",
"auth": "none",
"read_only": true,
"risk": "read_only_reference_information",
"service_id": "ursy-finance",
"parent_id": "",
"name": "Provenance Get",
"summary": "Get source, rights, methodology and accepted snapshot provenance. Financial reference/information data only. Not personalised financial advice, not an execution venue, and not a guarantee of a tradable price.",
"source_url": "https://ursy.finance/.well-known/ursy-capabilities.json",
"source_type": "capability_manifest",
"verified_at": "2026-09-26 06:31:27",
"revision": "feec693e01a21829af8590d98cc224b9fcc11bd212dff86b37978a50741a62ba",
"type": "capabilities",
"source": {
"url": "https://ursy.finance/.well-known/ursy-capabilities.json",
"type": "capability_manifest"
},
"last_verified_at": "2026-09-26 06:31:27",
"stale": true
}