Artsdata

{'type': 'object', 'title': 'GetEntityRequest', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['uri'], 'properties': {'uri': {'type': 'string', 'format': 'uri', 'description': 'The Artsdata entity URI.'}}, 'description': 'Request schema for the get_entity tool.', 'additionalProperties': False}

{'type': 'object', '$defs': {'typeItem': {'type': 'object', 'required': ['uri', 'label'], 'properties': {'uri': {'type': 'string', 'format': 'uri'}, 'label': {'type': 'string'}}, 'additionalProperties': False}, 'stringList': {'type': 'string'}, 'entityDetails': {'type': 'object', 'required': ['id', 'uri'], 'properties': {'id': {'type': 'string', 'description': 'Artsdata identifier of the referenced entity.'}, 'uri': {'type': 'string', 'format': 'uri', 'description': 'URI of the referenced entity.'}, 'name': {'type': 'string', 'description': 'Preferred label of the referenced entity, in the requested language when available.'}}, 'additionalProperties': False}, 'additionalProperty': {'type': 'object', 'required': ['predicate', 'values'], 'properties': {'values': {'type': 'array', 'items': {'type': 'string'}}, 'predicate': {'type': 'object', 'required': ['uri', 'label'], 'properties': {'uri': {'type': 'string', 'format': 'uri'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'multiLingualString': {'type': 'object', 'required': ['value'], 'properties': {'value': {'type': 'string'}, 'language': {'type': 'string', 'description': "BCP 47 language tag (e.g., 'en', 'fr')."}}, 'additionalProperties': False}}, 'title': 'GetEntityResponse', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['id', 'uri', 'types', 'name'], 'properties': {'id': {'type': 'string', 'description': 'Unique identifier of the entity.'}, 'uri': {'type': 'string', 'format': 'uri', 'description': 'URI representing the entity.'}, 'name': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}, 'types': {'type': 'array', 'items': {'$ref': '#/$defs/typeItem'}}, 'same_as': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}}, 'end_date': {'oneOf': [{'type': 'string', 'format': 'date'}, {'type': 'string', 'format': 'date-time'}], 'description': 'End date or end date-time of an event (ISO 8601).'}, 'location': {'type': 'array', 'items': {'$ref': '#/$defs/entityDetails'}, 'description': 'List of locations, each with its Artsdata id, URI and name.'}, 'organizer': {'type': 'array', 'items': {'$ref': '#/$defs/entityDetails'}, 'description': 'List of organizers, each with its Artsdata id, URI and name.'}, 'performer': {'type': 'array', 'items': {'$ref': '#/$defs/entityDetails'}, 'description': 'List of performers, each with its Artsdata id, URI and name.'}, 'start_date': {'oneOf': [{'type': 'string', 'format': 'date'}, {'type': 'string', 'format': 'date-time'}], 'description': 'Start date or start date-time of an event (ISO 8601).'}, 'description': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}, 'event_status': {'type': 'string', 'format': 'uri', 'description': 'Status of the event, it can one from the enumeration members of https://schema.org/EventStatusType'}, 'alternate_names': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}, 'main_entity_of_page': {'type': 'string', 'format': 'uri', 'description': 'URI of the main entity page.'}, 'additional_properties': {'type': 'array', 'items': {'$ref': '#/$defs/additionalProperty'}}, 'event_attendance_mode': {'type': 'string', 'format': 'uri', 'description': 'Attendance mode of the event, it can one from the enumeration members of https://schema.org/EventAttendanceModeEnumeration'}, 'has_event_type_concept': {'type': 'array', 'items': {'$ref': '#/$defs/stringList'}, 'description': 'Concept URIs from the Artsdata Event Types vocabulary (adr:ArtsdataEventTypes)'}, 'disambiguatingDescription': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}}, 'description': 'Response schema for the get_entity tool.', 'additionalProperties': False}

{'type': 'object', 'title': 'GetSchemaRequest', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'properties': {}, 'description': 'Request schema for the get_schema tool. The tool takes no arguments.', 'additionalProperties': False}

{'type': 'object', '$defs': {'curies': {'type': 'array', 'items': {'type': 'string'}}, 'property': {'type': 'object', 'required': ['path', 'required'], 'properties': {'in': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Allowed values.'}, 'path': {'type': 'string', 'description': 'SPARQL property path.'}, 'label': {'type': 'string'}, 'range': {'$ref': '#/$defs/curies'}, 'classes': {'$ref': '#/$defs/curies', 'description': 'Class(es) of the linked node.'}, 'pattern': {'type': 'string', 'description': 'Regex the value (as a string) matches.'}, 'required': {'type': 'boolean', 'description': 'sh:minCount >= 1.'}, 'severity': {'type': 'string', 'description': 'Omitted for sh:Violation.'}, 'datatypes': {'$ref': '#/$defs/curies'}, 'has_value': {'type': 'array', 'items': {'type': 'string'}}, 'max_count': {'type': 'integer', 'minimum': 0}, 'min_count': {'type': 'integer', 'minimum': 2, 'description': 'Only present when greater than 1.'}, 'node_kind': {'enum': ['IRI', 'Literal', 'BlankNode', 'BlankNodeOrIRI', 'BlankNodeOrLiteral', 'IRIOrLiteral'], 'type': 'string'}, 'description': {'type': 'string'}, 'language_in': {'type': 'array', 'items': {'type': 'string'}}, 'unique_lang': {'type': 'boolean'}, 'value_shape': {'type': 'object', 'required': ['properties'], 'properties': {'label': {'type': 'string'}, 'properties': {'type': 'array', 'items': {'$ref': '#/$defs/property'}}}, 'additionalProperties': False}, 'sub_property_of': {'$ref': '#/$defs/curies'}, 'equivalent_properties': {'$ref': '#/$defs/curies'}}, 'additionalProperties': False}}, 'title': 'GetSchemaResponse', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['about', 'conventions', 'prefixes', 'classes', 'vocabularies'], 'properties': {'about': {'type': 'object', 'required': ['source', 'sparql_endpoint'], 'properties': {'title': {'type': 'string'}, 'source': {'type': 'string', 'format': 'uri', 'description': 'Turtle file the digest was compiled from.'}, 'version': {'type': 'string'}, 'modified': {'type': 'string'}, 'namespace': {'type': 'string', 'format': 'uri'}, 'description': {'type': 'string'}, 'sparql_endpoint': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, 'classes': {'type': 'array', 'items': {'type': 'object', 'required': ['class', 'properties'], 'properties': {'class': {'type': 'string', 'description': 'Class to use with rdf:type / a.'}, 'label': {'type': 'string'}, 'shapes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'SHACL node shapes merged into this entry.'}, 'comment': {'type': 'string'}, 'properties': {'type': 'array', 'items': {'$ref': '#/$defs/property'}}, 'subclass_of': {'type': 'array', 'items': {'type': 'string'}}, 'alternate_names': {'type': 'array', 'items': {'type': 'string'}}, 'equivalent_classes': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'prefixes': {'type': 'object', 'description': 'Prefix name -> namespace IRI.', 'additionalProperties': {'type': 'string', 'format': 'uri'}}, 'conventions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'How to read the digest and write SPARQL against the graph.'}, 'vocabularies': {'type': 'array', 'items': {'type': 'object', 'required': ['property', 'scheme'], 'properties': {'label': {'type': 'string'}, 'scheme': {'type': 'string', 'description': "skos:ConceptScheme the property's values are in."}, 'classes': {'type': 'array', 'items': {'type': 'string'}}, 'property': {'type': 'string'}}, 'additionalProperties': False}}}, 'description': 'Response schema for the get_schema tool: the Artsdata data model (ontology + CORE graph SHACL shapes) compiled into a class-centric digest. IRIs are CURIEs over `prefixes` (or <full-IRI> when no prefix fits); property paths are SPARQL 1.1 property paths.', 'additionalProperties': False}

{'type': 'object', 'title': 'SearchQueryRequest', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1, 'description': 'Number of results to return.'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Non-empty mandatory search query.'}, 'types': {'type': 'array', 'items': {'enum': ['http://schema.org/Event', 'http://schema.org/Place', 'http://schema.org/Person', 'http://schema.org/Organization', 'http://dbpedia.org/ontology/Agent', 'http://www.w3.org/2004/02/skos/core#Concept'], 'type': 'string', 'format': 'uri'}, 'description': 'Optional list of type filters; can be empty.', 'uniqueItems': True}, 'language': {'enum': ['en', 'fr'], 'type': 'string', 'default': 'en', 'description': "Language code, restricted to 'en' or 'fr'."}, 'in_scheme': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'description': "Optional list of Artsdata controlled vocabulary (skos:ConceptScheme) URIs (e.g., ['http://kg.artsdata.ca/resource/ArtsdataEventTypes']). Paired with types: ['http://www.w3.org/2004/02/skos/core#Concept']. Use it to find a concept URI by its label (e.g., the event type for 'exhibition') for use in search_events under has_event_type_concept. Can be left empty.", 'uniqueItems': True}}, 'description': 'Request schema for the search_entities tool.', 'additionalProperties': False}

{'type': 'object', 'title': 'SearchEntitiesResponse', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'type', 'uri'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string'}, 'type': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string'}}, 'additionalProperties': False}}, 'description': {'type': 'string'}}, 'additionalProperties': False}}}, 'description': 'Response schema for the search_entities tool.', 'additionalProperties': False}

{'type': 'object', 'title': 'SearchEventsRequest', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1, 'description': 'Number of results to return.'}, 'places': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'description': 'Optional list of Artsdata VENUE URIs (e.g., ["http://kg.artsdata.ca/resource/K11-2"]) for a theatre, hall, auditorium, room or stage. Only venue URIs work: a city, region or country (e.g. \'Toronto\', \'Ontario\', \'Canada\') is not a venue and returns no events. First find the venue\'s URI with search_entities (types: [\'http://schema.org/Place\']) using the venue name. A venue URI also covers the rooms and halls inside it (schema:containedInPlace). To find events in a city or region, use sparql_query. Can be left empty.', 'uniqueItems': True}, 'artists': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'description': 'Optional list of Artsdata artist URIs (e.g., ["http://kg.artsdata.ca/resource/K2-6574"]). If you only have a name, use search_entities (types: [\'Person\']) to find its URI first. Can be left empty.', 'uniqueItems': True}, 'language': {'type': 'string', 'default': 'en', 'description': "Language for the labels in the response (e.g. 'en', 'fr'); default is 'en'. This selects the output language only — it does NOT filter events by the language they are performed in."}, 'startDateTo': {'type': 'string', 'description': 'Optional upper bound filter. Includes events starting on or before this date/time. ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ssZ).'}, 'organizations': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'description': 'Optional list of Artsdata organization URIs (e.g., ["http://kg.artsdata.ca/resource/K5-72"]). If you only have a name, use search_entities (types: [\'Organization\']) to find its URI first. Can be left empty.', 'uniqueItems': True}, 'startDateFrom': {'type': 'string', 'description': 'Optional lower bound filter. Includes events starting on or after this date/time. ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ssZ).'}, 'has_event_type_concept': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'description': 'Optional list of concept URIs from the Artsdata Event Types vocabulary (http://kg.artsdata.ca/resource/ArtsdataEventTypes). Must be valid concept URIs (e.g., http://kg.artsdata.ca/resource/ClassicalMusicPerformance). Non-matching inputs—such as text labels, schema.org classes, or external vocabularies—will return zero results without throwing an error. Resolve any name or label to its URI with search_entities first', 'uniqueItems': True}}, 'description': 'Request schema for the search_events tool.', 'additionalProperties': False}

{'type': 'object', '$defs': {'typeItem': {'type': 'object', 'required': ['uri', 'label'], 'properties': {'uri': {'type': 'string', 'format': 'uri'}, 'label': {'type': 'string'}}, 'additionalProperties': False}, 'stringList': {'type': 'string'}, 'entityDetails': {'type': 'object', 'required': ['id', 'uri'], 'properties': {'id': {'type': 'string', 'description': 'Artsdata identifier of the referenced entity.'}, 'uri': {'type': 'string', 'format': 'uri', 'description': 'URI of the referenced entity.'}, 'name': {'type': 'string', 'description': 'Preferred label of the referenced entity, in the requested language when available.'}}, 'additionalProperties': False}, 'additionalProperty': {'type': 'object', 'required': ['predicate', 'values'], 'properties': {'values': {'type': 'array', 'items': {'type': 'string'}}, 'predicate': {'type': 'object', 'required': ['uri', 'label'], 'properties': {'uri': {'type': 'string', 'format': 'uri'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'multiLingualString': {'type': 'object', 'required': ['value'], 'properties': {'value': {'type': 'string'}, 'language': {'type': 'string', 'description': "BCP 47 language tag (e.g., 'en', 'fr')."}}, 'additionalProperties': False}}, 'title': 'SearchEventsResponse', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'uri', 'types', 'name'], 'properties': {'id': {'type': 'string', 'description': 'Unique identifier of the entity.'}, 'uri': {'type': 'string', 'format': 'uri', 'description': 'URI representing the entity.'}, 'name': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}, 'types': {'type': 'array', 'items': {'$ref': '#/$defs/typeItem'}}, 'same_as': {'type': 'array', 'items': {'type': 'string'}}, 'end_date': {'oneOf': [{'type': 'string', 'format': 'date'}, {'type': 'string', 'format': 'date-time'}], 'description': 'End date or end date-time of an event (ISO 8601).'}, 'location': {'type': 'array', 'items': {'$ref': '#/$defs/entityDetails'}, 'description': 'List of locations, each with its Artsdata id, URI and name.'}, 'organizer': {'type': 'array', 'items': {'$ref': '#/$defs/entityDetails'}, 'description': 'List of organizers, each with its Artsdata id, URI and name.'}, 'performer': {'type': 'array', 'items': {'$ref': '#/$defs/entityDetails'}, 'description': 'List of performers, each with its Artsdata id, URI and name.'}, 'start_date': {'oneOf': [{'type': 'string', 'format': 'date'}, {'type': 'string', 'format': 'date-time'}], 'description': 'Start date or start date-time of an event (ISO 8601).'}, 'description': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}, 'event_status': {'type': 'string', 'format': 'uri', 'description': 'Status of the event, it can one from the enumeration members of https://schema.org/EventStatusType'}, 'alternate_names': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}, 'main_entity_of_page': {'type': 'string', 'format': 'uri', 'description': 'URI of the main entity page.'}, 'additional_properties': {'type': 'array', 'items': {'$ref': '#/$defs/additionalProperty'}}, 'event_attendance_mode': {'type': 'string', 'format': 'uri', 'description': 'Attendance mode of the event, it can one from the enumeration members of https://schema.org/EventAttendanceModeEnumeration'}, 'has_event_type_concept': {'type': 'array', 'items': {'$ref': '#/$defs/stringList'}, 'description': 'Concept URIs from the Artsdata Event Types vocabulary (adr:ArtsdataEventTypes)'}, 'disambiguatingDescription': {'type': 'array', 'items': {'$ref': '#/$defs/multiLingualString'}}}, 'additionalProperties': False}}}, 'description': 'Response schema for the search_events tool.', 'additionalProperties': False}

{'type': 'object', 'title': 'SparqlQueryRequest', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['query'], 'properties': {'query': {'type': 'string', 'minLength': 1, 'description': 'A complete SPARQL 1.1 SELECT or ASK query, with a PREFIX declaration for every prefix it uses. Build it from the classes, properties and prefixes returned by get_schema, and add a LIMIT.'}}, 'description': 'Request schema for the sparql_query tool.', 'additionalProperties': False}

{'type': 'object', '$defs': {'rdfTerm': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'enum': ['uri', 'literal', 'bnode', 'triple'], 'type': 'string', 'description': "'triple' is an RDF-star quoted triple, whose value is an object with subject, predicate and object terms."}, 'value': {'anyOf': [{'type': 'string'}, {'type': 'object'}]}, 'datatype': {'type': 'string', 'description': 'Datatype IRI of a typed literal.'}, 'xml:lang': {'type': 'string', 'description': 'Language tag of a language-tagged literal.'}}}}, 'title': 'SparqlQueryResponse', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'version': '1.0.0', 'required': ['head'], 'properties': {'head': {'type': 'object', 'properties': {'link': {'type': 'array', 'items': {'type': 'string'}}, 'vars': {'type': 'array', 'items': {'type': 'string'}, 'description': "The projected variable names, without the leading '?'."}}}, 'boolean': {'type': 'boolean', 'description': 'The answer to an ASK query.'}, 'results': {'type': 'object', 'required': ['bindings'], 'properties': {'bindings': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {'$ref': '#/$defs/rdfTerm'}}, 'description': 'One object per solution, keyed by variable name. Unbound variables (e.g. from OPTIONAL) are absent.'}}}, 'truncated': {'type': 'boolean', 'description': "Present and true when the endpoint returned more rows than the server's row cap and only the first rows are included. Add or lower the LIMIT, or page with OFFSET."}}, 'description': "Response schema for the sparql_query tool: the endpoint's SPARQL 1.1 Query Results JSON (https://www.w3.org/TR/sparql11-results-json/), as returned. A SELECT gives head.vars and results.bindings; an ASK gives boolean."}