Capabilities
Series Compare
Compare exact shared dates, with explicit transforms and source lineage. 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:series-compare- 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:series-compare",
"mcp_tool": "compare_series",
"description": "Compare exact shared dates, with explicit transforms and source lineage. Financial reference/information data only. Not personalised financial advice, not an execution venue, and not a guarantee of a tradable price.",
"routes": [
{
"operation_id": "compareSeries",
"method": "POST",
"url": "https://ursy.finance/wp-json/ursy-finance/v2/compare",
"rate_limit": {
"bucket": "calculations",
"requests_per_minute": 30
},
"mcp_rate_limit": {
"bucket": "mcp",
"requests_per_minute": 60
}
}
],
"input_schema": {
"type": "object",
"properties": {
"instruments": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160
},
"minItems": 2,
"maxItems": 4,
"uniqueItems": true
},
"range": {
"type": "object",
"properties": {
"start": {
"type": "string",
"format": "date"
},
"end": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false,
"required": [
"start",
"end"
]
},
"normalize": {
"type": "boolean",
"default": true
},
"transform": {
"type": "string",
"enum": [
"raw",
"rebased_100",
"percentage_change"
]
}
},
"required": [
"instruments",
"range"
],
"additionalProperties": false
},
"output_schema": {
"type": "object",
"properties": {
"schema": {
"const": "ursy.finance/comparison/v2"
},
"series": {
"type": "array",
"items": {
"type": "object",
"properties": {
"schema": {
"const": "ursy.finance/series/v2"
},
"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"
]
},
"frequency": {
"type": "string"
},
"unit": {
"type": "string"
},
"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"
]
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
]
},
"state": {
"enum": [
"historical",
"unavailable"
]
},
"time": {
"type": "object",
"properties": {
"observation_at": {
"type": "string"
},
"published_at": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"served_at": {
"type": "string"
}
},
"required": [
"observation_at",
"published_at",
"retrieved_at",
"served_at"
]
},
"calculation": {
"type": "object",
"properties": {
"derived": {
"type": "boolean"
},
"method": {
"type": "string"
},
"formula": {
"type": [
"string",
"null"
]
},
"input_observations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"series": {
"type": "string"
},
"observation_date": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"source_id",
"series",
"observation_date",
"value"
]
}
}
},
"required": [
"derived",
"method",
"formula",
"input_observations"
]
},
"integrity": {
"type": "object"
}
},
"required": [
"date",
"value",
"state",
"time",
"calculation",
"integrity"
]
}
},
"missing_periods": {
"type": "array",
"items": {
"type": "string"
}
},
"missing_data_policy": {
"type": "string"
},
"pagination": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"has_more": {
"type": "boolean"
}
},
"required": [
"total",
"limit",
"offset",
"has_more"
]
},
"range": {
"type": "object"
},
"available_range": {
"type": "object"
},
"date_convention": {
"type": "object"
},
"derived": {
"type": "boolean"
},
"revision_status": {
"type": "object"
},
"data_state_rules": {
"type": "object"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"snapshot": {
"type": [
"object",
"null"
]
},
"snapshot_id": {
"type": [
"string",
"null"
]
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"ordering": {
"type": "string"
},
"warning_codes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"schema",
"instrument",
"frequency",
"unit",
"source",
"points",
"missing_periods",
"missing_data_policy",
"pagination",
"range",
"available_range",
"date_convention",
"derived",
"revision_status",
"data_state_rules",
"warnings"
]
}
},
"matched_dates": {
"type": "array",
"items": {
"type": "string"
}
},
"missing_dates": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
},
"statistics": {
"type": "object",
"additionalProperties": {
"type": "object",
"properties": {
"first_date": {
"type": "string"
},
"last_date": {
"type": "string"
},
"first_value": {
"type": "number"
},
"last_value": {
"type": "number"
},
"absolute_change": {
"type": [
"number",
"null"
]
},
"percentage_change": {
"type": [
"number",
"null"
]
},
"basis_point_change": {
"type": [
"number",
"null"
]
},
"sample_count": {
"type": "integer"
},
"formula": {
"type": "object"
},
"input_window": {
"type": "object"
},
"missing_data_handling": {
"type": "string"
}
},
"required": [
"first_date",
"last_date",
"first_value",
"last_value",
"absolute_change",
"percentage_change",
"basis_point_change",
"sample_count",
"formula",
"input_window",
"missing_data_handling"
]
}
},
"indexed": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"date",
"value"
]
}
}
},
"normalization": {
"type": "object"
},
"comparability": {
"type": "object",
"properties": {
"same_frequency": {
"type": "boolean"
},
"same_observation_window": {
"type": "boolean"
},
"date_keys_match": {
"type": "boolean"
},
"warning": {
"type": "string"
}
},
"required": [
"same_frequency",
"same_observation_window",
"date_keys_match",
"warning"
]
},
"sample_count": {
"type": "integer"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"schema",
"series",
"matched_dates",
"missing_dates",
"statistics",
"indexed",
"normalization",
"comparability",
"sample_count",
"warnings"
]
},
"data_class": "reference",
"auth": "none",
"read_only": true,
"risk": "read_only_reference_information",
"service_id": "ursy-finance",
"parent_id": "",
"name": "Series Compare",
"summary": "Compare exact shared dates, with explicit transforms and source lineage. 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": "0969aac4babde8bfea8899d3a344f775054f7f97b56c51c49dde90e84d71f938",
"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
}