Search FOLIO concepts by label (name).

Finds legal concepts whose names match the query using fuzzy matching. Use this as the primary entry point for finding concepts.

Args: query: Search term (e.g., "bankruptcy", "software license", "trust"). limit: Maximum number of results to return (default 10).

Returns: JSON array of matching concepts with iri, label, definition, and score.

Search FOLIO concepts by definition text.

Finds legal concepts whose definitions match the query. Use this when searching by name doesn't find what you need.

Args: query: Search term to match against definitions. limit: Maximum number of results to return (default 10).

Returns: JSON array of matching concepts with iri, label, definition, and score.

Get full details for a specific FOLIO concept by IRI.

Accepts short IDs (e.g., "RSYBzf149Mi5KE0YtmpUmr"), full IRIs (e.g., "https://folio.openlegalstandard.org/RSYBzf149Mi5KE0YtmpUmr"), or partial matches.

Args: iri: The concept IRI or identifier.

Returns: Full JSON representation of the concept, or an error message.

Export a FOLIO concept in a specific format.

Args: iri: The concept IRI or identifier. format: Output format — "markdown", "jsonld", or "owl_xml".

Returns: The concept in the requested format, or an error message.

List all FOLIO taxonomy branches with concept counts.

Returns the 24 top-level categories of the FOLIO ontology (e.g., areas_of_law, document_artifacts, legal_entities).

Returns: JSON object mapping branch names to concept counts.

Get concepts in a FOLIO taxonomy branch. Returns compact summaries.

Args: branch_name: Branch name (e.g., "areas_of_law", "document_artifacts"). Use list_branches() to see all available branch names. max_depth: Depth limit. Use 1 (default) for top-level only. WARNING: depth >2 can return very large results. Navigate incrementally with get_children() instead.

Returns: JSON array of {iri, label, definition} summaries. Use get_concept(iri) for full details on a specific concept.

Get child concepts of a FOLIO concept. Returns compact summaries.

Args: iri: A concept IRI (e.g., "https://folio.openlegalstandard.org/R07tQM...") or short ID (e.g., "R07tQM..."). NOT a branch name — use get_taxonomy_branch for branch names like "areas_of_law". max_depth: Depth limit (default 1 for direct children). Keep at 1-2 to avoid large results.

Returns: JSON array of {iri, label, definition} summaries. Use get_concept(iri) for full details on a specific child.

Get parent concepts of a FOLIO concept. Returns compact summaries.

Args: iri: A concept IRI (e.g., "https://folio.openlegalstandard.org/R07tQM...") or short ID. NOT a branch name. max_depth: Depth limit (default 1 for direct parents).

Returns: JSON array of {iri, label, definition} summaries. Use get_concept(iri) for full details on a specific parent.

Get all OWL object properties defined in the FOLIO ontology.

Returns properties that describe relationships between concepts (e.g., "hasJurisdiction", "appliesTo", "governedBy").

Returns: JSON array of properties with iri, label, definition, domain, and range.

Find semantic connections (triples) between FOLIO concepts.

Searches for subject-property-object triples. At minimum, provide a subject_iri. Optionally filter by property and/or object.

Args: subject_iri: IRI of the subject concept. property_name: Optional property name or IRI to filter by. object_iri: Optional object concept IRI to filter by.

Returns: JSON array of triples [{subject: {...}, property: {...}, object: {...}}].

Query FOLIO concepts with composable text and structural filters.

More powerful than search_concepts — supports field-specific matching, structural constraints, and multiple match modes. All specified filters must match (AND logic).

Text filters: label: Match against the concept's primary label (rdfs:label). definition: Match against the concept's definition (skos:definition). alt_label: Match against alternative labels (skos:altLabel). example: Match against examples (skos:example). any_text: Match against ALL text fields (label, definition, alt_labels, examples, notes, comment).

Structural filters: branch: Limit to a taxonomy branch (e.g., "AREA_OF_LAW", "CURRENCY", "LEGAL_ENTITY"). parent_iri: Only descendants of this IRI (transitive subClassOf). has_children: True = non-leaf concepts only, False = leaf concepts only. deprecated: Include deprecated concepts (default False). country: Match against the country field.

Control: match_mode: "substring" (default), "exact", "regex", or "fuzzy". limit: Maximum results (default 20).

Returns: JSON array of matching concepts.

Query FOLIO object properties with composable text and structural filters.

Replaces get_properties() when you need filtered results instead of the full list.

Text filters: label: Match against property label (e.g., "jurisdiction", "applies"). definition: Match against property definition.

Structural filters: domain_iri: Only properties whose domain includes this class IRI. range_iri: Only properties whose range includes this class IRI. has_inverse: True = only properties with inverses, False = only without.

Control: match_mode: "substring" (default), "exact", "regex", or "fuzzy". limit: Maximum results (default 20).

Returns: JSON array of matching properties with iri, label, definition, domain, range.