Private Law Wiki MCP
An MCP server providing tools for querying a legal knowledge base on international private law, tax regimes, banking, and citizenship. It supports asking questions, searching documents, assessing bank cases, and comparing legal answers with sourced official quotations.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://wiki.private.law/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Ask legal questions about international private law
- Search the wiki for tax and banking information
- Assess bank cases using sourced data
- Compare legal answers across jurisdictions
Source and maintenance
Community listingRegistry 3.9.0
Protocol and capabilities
- Server
- wiki-private-law 3.9.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
ask — Ask the Private Law wiki
Advertised read-only
Answer a question by quoting a published wiki article, or — when the question names one country, programme, tax regime, bank or legal form and asks one of its reviewed questions — with the reviewed structured answer and its verbatim official quotation. Never generated at request time; always carries the URL it came from. Returns confident=false with suggested reading when the corpus does not cover the question or when context genuinely conflicts. When the question names one reviewed object and several of its reviewed questions fit the wording without a confident match, the answer (if any) is an ordinary article quotation and structuredResolution carries the clarification: question_ambiguous with candidate topics and their admission state. A question naming several distinct reviewed objects, or mapped to one reviewed topic whose answer is withdrawn or held, returns confident=false, refusalReason structured_held and no article text; ask about one object or use answer_compare. Bare MSO means the Hong Kong Money Service Operator licence; use Management Services Organization or regulated-practice context for the broader platform concept. Ask in the language you want answered — Russian and English are both first-class.
ask input schema
{
"type": "object",
"required": [
"question"
],
"properties": {
"locale": {
"enum": [
"ru",
"en",
"ko",
"zh-hant"
],
"type": "string",
"description": "Corpus language; inferred from the question when omitted."
},
"question": {
"type": "string",
"description": "A natural-language question, up to 2000 characters."
}
}
}ask output schema
{
"type": "object",
"required": [
"confident",
"answer",
"citations",
"suggestedReading",
"queryInterpretation"
],
"properties": {
"answer": {
"type": [
"string",
"null"
]
},
"locale": {
"type": "string"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"provenance"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"distance": {
"type": [
"number",
"null"
]
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
}
}
}
},
"confident": {
"type": "boolean"
},
"threshold": {
"type": "number"
},
"topDistance": {
"type": [
"number",
"null"
]
},
"refusalReason": {
"type": [
"string",
"null"
]
},
"structuredCell": {
"type": "object",
"required": [
"object",
"question",
"answers",
"url",
"provenance"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"object": {
"type": "object",
"required": [
"code",
"name",
"type"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
}
}
},
"answers": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"properties": {
"temporalRecordedClauses": {
"type": "null"
}
}
},
{
"required": [
"temporalRecordedClauses",
"machineApplicability",
"valueRaw"
],
"properties": {
"valueRaw": {
"type": "null"
},
"machineApplicability": {
"const": "unknown"
}
}
}
],
"required": [
"statement",
"caveat",
"conditions",
"sources"
],
"properties": {
"ref": {
"type": "string"
},
"role": {
"type": "string"
},
"valid": {},
"value": {},
"caveat": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"quote",
"url",
"title",
"sourceDate",
"checked",
"quoteTranslation",
"verification"
],
"properties": {
"url": {
"type": "string"
},
"quote": {
"type": "string",
"description": "Verbatim text of the official source."
},
"title": {
"type": "string"
},
"checked": {
"type": "string",
"description": "Actual native date the quotation was checked in the current stored snapshot; not proof of current law."
},
"locator": {},
"language": {
"type": [
"string",
"null"
],
"description": "Language recorded for the native quotation."
},
"sourceDate": {
"type": [
"string",
"null"
],
"description": "The native source document date; null when unknown. Separate from quotation verification."
},
"sourceKind": {
"type": [
"string",
"null"
],
"description": "Native source kind; null when withheld from the public projection."
},
"sourceClass": {
"type": [
"string",
"null"
],
"description": "Normal source classification from the admitted B item."
},
"evidenceNote": {
"type": "string",
"description": "Full native explanation of the limited role of this source."
},
"evidenceRole": {
"enum": [
"provider_identity"
],
"type": "string",
"description": "Identity-only required evidence; not proof of the answer tariff or current client eligibility."
},
"verification": {
"type": "string"
},
"quoteTranslation": {
"type": [
"string",
"null"
],
"description": "Exact translation supplied by the native source record; null when absent."
},
"sourceQualification": {
"type": [
"object",
"null"
],
"description": "Source qualification from the admitted B item, when present."
},
"translationLanguage": {
"type": [
"string",
"null"
],
"description": "Language of the exact quotation translation; null when absent."
},
"verificationFingerprint": {
"type": "object",
"required": [
"version",
"snapshotRepresentation",
"snapshotSha256",
"quoteLiteralSha256",
"membershipRecipe",
"checkIdentitySha256",
"fingerprintSha256"
],
"properties": {
"version": {
"type": "integer"
},
"snapshotSha256": {
"type": "string"
},
"membershipRecipe": {
"type": "string"
},
"fingerprintSha256": {
"type": "string"
},
"quoteLiteralSha256": {
"type": "string"
},
"checkIdentitySha256": {
"type": "string"
},
"snapshotRepresentation": {
"type": "string"
}
},
"description": "Exact B source snapshot and quotation fingerprint; not current-law proof."
}
}
}
},
"valueRaw": {},
"statement": {
"type": "string"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"valueState": {
"type": "string"
},
"nativeScope": {
"type": "array"
},
"recordedText": {
"type": "string"
},
"exceptionOfRef": {
"type": [
"string",
"null"
],
"description": "Exact native parent answer reference; null when absent. No parent is inferred."
},
"machineApplicability": {},
"temporalRecordedClauses": {
"type": "object",
"required": [
"schema_version",
"status",
"machine_applicability",
"selected_value_raw",
"publication_admission",
"source_evidence_bound",
"display_note",
"source_spans",
"clauses"
],
"properties": {
"status": {
"const": "source_bound"
},
"clauses": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"duration_output"
],
"properties": {
"time_kind": {
"const": "duration"
},
"endpoint_output": {
"type": "null"
}
}
},
{
"required": [
"endpoint_output"
],
"properties": {
"time_kind": {
"const": "endpoint"
},
"duration_output": {
"type": "null"
}
}
}
],
"required": [
"id",
"evidence_span_ids",
"events",
"label",
"target",
"display",
"issuer",
"authority",
"modality_governs",
"counting",
"condition_note",
"pause_note",
"extension_note",
"applicability",
"claim_kind",
"authority_kind",
"modality_kind",
"modality_word",
"time_kind",
"scope",
"actors",
"event_targets",
"pauses",
"extensions",
"conditions",
"omitted"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": [
"string",
"null"
]
},
"scope": {
"type": "object",
"required": [
"region",
"cohort"
],
"properties": {
"cohort": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"actors": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"events": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"from": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"event": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"issuer": {
"type": [
"string",
"null"
]
},
"pauses": {
"type": "array",
"items": {
"type": "string"
}
},
"target": {
"type": [
"string",
"null"
]
},
"display": {
"type": [
"string",
"null"
]
},
"omitted": {
"type": "array",
"items": {
"type": "string"
}
},
"counting": {
"type": [
"string",
"null"
]
},
"authority": {
"type": [
"string",
"null"
]
},
"time_kind": {
"enum": [
"duration",
"endpoint"
]
},
"claim_kind": {
"enum": [
"normative_rule",
"agency_estimate",
"firm_estimate",
"validity_window",
"eligibility_requirement",
"source_event",
"not_established"
]
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"extensions": {
"type": "array",
"items": {
"type": "string"
}
},
"pause_note": {
"type": [
"string",
"null"
]
},
"applicability": {
"type": [
"string",
"null"
]
},
"event_targets": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"modality_kind": {
"enum": [
"unqualified",
"usual",
"estimate",
"not_established"
]
},
"modality_word": {
"type": [
"string",
"null"
]
},
"authority_kind": {
"enum": [
"law",
"agency_guidance",
"firm",
"not_established"
]
},
"condition_note": {
"type": [
"string",
"null"
]
},
"extension_note": {
"type": [
"string",
"null"
]
},
"duration_output": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"value",
"counting",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_duration"
},
"value": {
"anyOf": [
{
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"per": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"jurisdiction"
],
"properties": {
"kind": {
"enum": [
"calendar_year",
"tax_year"
]
},
"jurisdiction": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"length",
"anchor"
],
"properties": {
"kind": {
"enum": [
"rolling",
"preceding",
"fixed_period"
]
},
"anchor": {
"type": "string"
},
"length": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
},
"bound": {
"enum": [
"gt",
"gte",
"lt",
"lte"
]
},
"approx": {
"type": "boolean"
},
"approximate": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"unit",
"range"
],
"properties": {
"per": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"jurisdiction"
],
"properties": {
"kind": {
"enum": [
"calendar_year",
"tax_year"
]
},
"jurisdiction": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"length",
"anchor"
],
"properties": {
"kind": {
"enum": [
"rolling",
"preceding",
"fixed_period"
]
},
"anchor": {
"type": "string"
},
"length": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
},
"range": {
"type": "object",
"required": [
"from",
"to",
"from_inclusive",
"to_inclusive"
],
"properties": {
"to": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"from": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"to_inclusive": {
"type": [
"boolean",
"null"
]
},
"from_inclusive": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"range"
],
"properties": {
"range": {
"type": "object",
"required": [
"from",
"to",
"from_inclusive",
"to_inclusive"
],
"properties": {
"to": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
},
"from": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
},
"to_inclusive": {
"type": "boolean"
},
"from_inclusive": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"unbounded"
],
"properties": {
"unbounded": {
"const": true
}
},
"additionalProperties": false
}
]
},
"counting": {
"enum": [
"calendar",
"business",
"not_stated"
]
},
"stage_relation": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"stage",
"spanIds"
],
"properties": {
"kind": {
"const": "total_stage"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"stage",
"baseStage",
"spanIds"
],
"properties": {
"kind": {
"const": "additional_to"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"baseStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"value",
"duration_basis",
"counting",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_duration"
},
"value": {
"type": "null"
},
"counting": {
"enum": [
"calendar",
"business",
"not_stated"
]
},
"duration_basis": {
"type": "object",
"required": [
"kind",
"basis",
"referenceStage",
"spanIds"
],
"properties": {
"kind": {
"const": "same_actual_prior_grant"
},
"basis": {
"const": "actual_individual_grant"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"referenceStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"stage_relation": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"stage",
"spanIds"
],
"properties": {
"kind": {
"const": "total_stage"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"stage",
"baseStage",
"spanIds"
],
"properties": {
"kind": {
"const": "additional_to"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"baseStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
}
]
},
"endpoint_output": {
"type": "object",
"required": [
"kind",
"value",
"boundary",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_endpoint"
},
"value": {
"anyOf": [
{
"type": "object",
"required": [
"v"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"precision": {
"const": "day"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"v",
"precision"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}$"
},
"precision": {
"const": "year"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"v",
"precision"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$"
},
"precision": {
"const": "month"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"precision",
"month",
"day"
],
"properties": {
"day": {
"type": "integer",
"maximum": 31,
"minimum": 1
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"precision": {
"const": "annual"
}
},
"additionalProperties": false
}
]
},
"boundary": {
"enum": [
"inclusive",
"exclusive",
"not_stated"
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
},
"modality_governs": {
"type": [
"string",
"null"
]
},
"evidence_span_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
"minItems": 1
},
"display_note": {
"type": "string"
},
"source_spans": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source_index",
"text",
"text_sha256",
"snapshot_sha256",
"quote_literal_sha256",
"start_byte",
"end_byte"
],
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"end_byte": {
"type": "integer",
"minimum": 1
},
"start_byte": {
"type": "integer",
"minimum": 0
},
"text_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"source_index": {
"type": "integer",
"minimum": 0
},
"snapshot_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"quote_literal_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Per-answer source indexes and verified UTF-8 coordinates in the Native snapshot. Snapshot offsets are owner-verified; this is not current-law or personal-applicability proof."
},
"schema_version": {
"const": 1
},
"selected_value_raw": {
"type": "null"
},
"machine_applicability": {
"const": "unknown"
},
"publication_admission": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
}
}
}
},
"question": {
"type": "object",
"required": [
"code",
"text"
],
"properties": {
"code": {
"type": "string"
},
"text": {
"type": "string"
},
"unit": {
"type": "string"
}
}
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
},
"materialVersion": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Content-addressed version of this complete native cell, including all qualifications and source evidence; independent of the request revision."
}
},
"description": "The unchanged public native whole cell, when admitted: per-answer source associations, recorded conditions and applicability remain separate from the rendered answer."
},
"suggestedReading": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"provenance"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"distance": {
"type": [
"number",
"null"
]
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
}
}
}
},
"queryInterpretation": {
"type": [
"object",
"null"
],
"required": [
"term",
"sense",
"ambiguous",
"message",
"choices"
],
"properties": {
"term": {
"enum": [
"MSO"
],
"type": "string"
},
"sense": {
"enum": [
"hong_kong_money_service_operator",
"regulated_practice_management",
"comparison",
"ambiguous"
],
"type": "string"
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"sense",
"slug",
"locale",
"title",
"description",
"url"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"sense": {
"enum": [
"hong_kong_money_service_operator",
"regulated_practice_management"
],
"type": "string"
},
"title": {
"type": "string"
},
"locale": {
"type": "string"
},
"description": {
"type": "string"
},
"labelLocale": {
"enum": [
"ru",
"en"
],
"type": "string",
"description": "Display-label language; locale remains the linked article language."
}
}
}
},
"message": {
"type": "string"
},
"ambiguous": {
"type": "boolean"
}
}
},
"structuredResolution": {
"type": "object",
"required": [
"status",
"reason",
"message",
"candidates"
],
"properties": {
"hold": {
"type": "string"
},
"retry": {
"type": "object",
"required": [
"tool",
"arguments"
],
"properties": {
"tool": {
"const": "answer_lookup"
},
"arguments": {
"type": "object",
"required": [
"object",
"questionCode",
"locale"
],
"properties": {
"locale": {
"enum": [
"ru",
"en"
]
},
"object": {
"type": "string"
},
"questionCode": {
"type": "string"
}
}
}
}
},
"reason": {
"enum": [
"native_owner_unavailable",
"object_ambiguous",
"question_ambiguous",
"question_unmatched",
"cell_held",
"invalid_native_cell",
"response_too_large"
],
"type": "string"
},
"status": {
"enum": [
"clarification_required",
"unavailable"
],
"type": "string"
},
"message": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"object",
"question",
"text",
"admission"
],
"properties": {
"text": {
"type": "string"
},
"object": {
"type": "string"
},
"question": {
"type": "string"
},
"admission": {
"enum": [
"pinned",
"pending_native_pin",
"withdrawn",
"locale_not_covered"
],
"type": "string"
}
}
},
"maxItems": 5
}
},
"description": "Resolution only. Candidate topics and retry arguments do not establish an available or verified answer."
}
}
}ask annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search — Search the Private Law wiki
Advertised read-only
Rank published articles for a query and return them with titles and URLs. Use when you want sources to read rather than a single answer. Search is sense-aware: bare MSO promotes only the Hong Kong Money Service Operator owner, professional-industry context promotes the regulated-practice platform, and genuinely conflicting context returns both with an explicit interpretation object.
search input schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Default 5."
},
"query": {
"type": "string",
"description": "Search terms or a question."
},
"locale": {
"enum": [
"ru",
"en",
"ko",
"zh-hant"
],
"type": "string"
}
}
}search output schema
{
"type": "object",
"required": [
"hits",
"queryInterpretation"
],
"properties": {
"hits": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"provenance"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"ranking": {
"type": [
"object",
"null"
],
"required": [
"contract",
"rank",
"method",
"fusionScore",
"lexicalRank",
"vectorRank",
"cosineDistance",
"ownerBonus",
"senseBonus"
],
"properties": {
"rank": {
"type": "integer",
"minimum": 1
},
"method": {
"enum": [
"lexical",
"rrf"
],
"type": "string"
},
"contract": {
"type": "string",
"const": "wiki-search-ranking/1"
},
"ownerBonus": {
"type": "number"
},
"senseBonus": {
"type": "number"
},
"vectorRank": {
"type": [
"integer",
"null"
],
"minimum": 1
},
"fusionScore": {
"type": [
"number",
"null"
]
},
"lexicalRank": {
"type": [
"integer",
"null"
],
"minimum": 1
},
"cosineDistance": {
"type": [
"number",
"null"
],
"description": "Best chunk distance within the retrieved pool; null when no measurement was obtained."
}
},
"description": "Retrieval ordering signals, not confidence or legal verification. Null for a producer without ranking metadata."
},
"distance": {
"type": [
"number",
"null"
]
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
}
}
}
},
"queryInterpretation": {
"type": [
"object",
"null"
],
"required": [
"term",
"sense",
"ambiguous",
"message",
"choices"
],
"properties": {
"term": {
"enum": [
"MSO"
],
"type": "string"
},
"sense": {
"enum": [
"hong_kong_money_service_operator",
"regulated_practice_management",
"comparison",
"ambiguous"
],
"type": "string"
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"sense",
"slug",
"locale",
"title",
"description",
"url"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"sense": {
"enum": [
"hong_kong_money_service_operator",
"regulated_practice_management"
],
"type": "string"
},
"title": {
"type": "string"
},
"locale": {
"type": "string"
},
"description": {
"type": "string"
},
"labelLocale": {
"enum": [
"ru",
"en"
],
"type": "string",
"description": "Display-label language; locale remains the linked article language."
}
}
}
},
"message": {
"type": "string"
},
"ambiguous": {
"type": "boolean"
}
}
}
}
}search annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}assess_bank_case — Assess a problem with a bank
Advertised read-only
The public endpoint defaults to format=json and textMode=compatible: the complete compact source graph is delivered once as JSON in content[0].text (96KiB whole-body cap), with a small wiki-bank-case-text/1 transport receipt in structuredContent. Text-only clients receive all native material except derived Markdown. Explicit summary puts the graph in structuredContent and only a notice in TextContent; use it only if your client consumes structuredContent. Explicit full preserves the previous full shape, up to2MiB. Internal callers without a boundary policy retain full compatible output. Compact overflow is held whole and offers a manual fresh-read full retry if your client accepts the larger response. Neither byte cap guarantees a model token limit. No material is truncated. The complaint desk's deterministic assessment for a frozen account, a closure notice, a document request, a stuck payment or a refused application: what to do now, the escalation ladder of the bank's jurisdiction (bank complaint, ombudsman or regulator, data access request), with recorded requirements, unresolved conditions and primary-source links, plus recorded response periods, cautions and the help that fits. Also returns the letters to send — the formal complaint and the data access request, in English with bracketed placeholders the person fills in themselves. The reported stage is an unverified intake fact; it does not establish completed steps or eligibility. No personal dates are calculated. calendarStatus explains the missing inputs. UK/EU complaint-response rules are returned separately as statutoryReply; the intake does not establish their applicable branch or a statutory due date. Pass holder whenever it is known: an ombudsman's door depends on whose account it is. Information, not legal advice. Never submit a person's contact details; hand them the complaint URL instead.
assess_bank_case input schema
{
"type": "object",
"required": [
"problem",
"stage",
"jurisdiction",
"amount",
"sanctions"
],
"properties": {
"stage": {
"enum": [
"notice",
"replied",
"deadline_passed",
"closed"
],
"type": "string"
},
"today": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Optional reference date (YYYY-MM-DD), retained for compatibility. It does not establish receipt of a complaint, the applicable procedure, eligibility or a personal due date."
},
"amount": {
"enum": [
"lt50k",
"50k_250k",
"250k_1m",
"gt1m"
],
"type": "string"
},
"format": {
"enum": [
"json",
"full"
],
"type": "string",
"default": "json",
"description": "Optional. Public HTTP default json selects wiki-bank-case-compact/1, preserving all native material except derived Markdown in a full-source graph, up to96KiB whole body. Explicit full retains the previous full DTO including Markdown and defaults to compatible text, up to2MiB. Direct/internal callers without a boundary policy retain full. No protocol-based selection or universal token-limit guarantee."
},
"holder": {
"enum": [
"individual",
"small_business",
"company"
],
"type": "string",
"description": "Whose account it is. Optional; without it eligibility is stated, not decided."
},
"locale": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"problem": {
"enum": [
"freeze",
"closure",
"kyc_request",
"payment_stuck",
"refused"
],
"type": "string"
},
"textMode": {
"enum": [
"compatible",
"summary"
],
"type": "string",
"default": "compatible",
"description": "Optional, default compatible. For json, compatible delivers one complete wiki-bank-case-compact/1 JSON graph in content[0].text and a small wiki-bank-case-text/1 transport receipt in structuredContent; validate its text bytes/hash and decode the graph before using sources. summary requires selected format=json and a client that consumes structuredContent; TextContent is only a notice. Explicit full+compatible retains the previous full DTO in both fields and may be large. Direct/internal defaults remain compatible."
},
"sanctions": {
"enum": [
"none",
"passport",
"business"
],
"type": "string",
"description": "Russia or Belarus nexus of the client."
},
"jurisdiction": {
"enum": [
"uk",
"eu",
"ch",
"sg",
"hk",
"us",
"uae",
"other"
],
"type": "string",
"description": "Where the bank or the neobank's licence sits."
}
}
}assess_bank_case output schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"headline",
"verdict",
"firstSteps",
"escalation",
"deadlines",
"calendar",
"letters",
"service",
"cautions",
"articles",
"complaintUrl"
],
"properties": {
"letters": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"title",
"purpose",
"body"
],
"properties": {
"body": {
"type": "string"
},
"kind": {
"enum": [
"complaint",
"data_request"
],
"type": "string"
},
"title": {
"type": "string"
},
"purpose": {
"type": "string"
}
}
}
},
"service": {
"type": "object",
"required": [
"id",
"title",
"why"
],
"properties": {
"id": {
"type": "string"
},
"why": {
"type": "string"
},
"title": {
"type": "string"
}
}
},
"verdict": {
"type": "string"
},
"articles": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"url",
"provenance"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
}
}
}
},
"calendar": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"date"
],
"properties": {
"date": {
"type": "string"
},
"label": {
"type": "string"
}
}
}
},
"cautions": {
"type": "array",
"items": {
"type": "string"
}
},
"headline": {
"type": "string"
},
"deadlines": {
"type": "array",
"items": {
"type": "string"
}
},
"escalation": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"when",
"how",
"who",
"status",
"statusNote"
],
"properties": {
"how": {
"type": "string"
},
"who": {
"type": "string"
},
"name": {
"type": "string"
},
"when": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"enum": [
"open",
"later",
"conditional",
"closed"
],
"type": "string"
},
"statusNote": {
"type": "string"
}
}
}
},
"firstSteps": {
"type": "array",
"items": {
"type": "string"
}
},
"complaintUrl": {
"type": "string"
},
"reportedStage": {
"enum": [
"notice",
"replied",
"deadline_passed",
"closed"
],
"type": "string",
"description": "Stage reported by the caller, not a verified procedural event or eligibility finding."
},
"calendarStatus": {
"type": "object",
"required": [
"state",
"reason",
"missingInputs"
],
"properties": {
"state": {
"enum": [
"not_calculated"
],
"type": "string"
},
"reason": {
"type": "string"
},
"missingInputs": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"statutoryReply": {
"type": [
"object",
"null"
],
"description": "UK/EU whole native complaint-reply cell with all conditions, caveats and quotations. Personal scope and statutory due date remain unknown. Null outside this cohort."
}
}
},
{
"type": "object",
"required": [
"format",
"complete",
"payload",
"sourcesById",
"materialSha256",
"materialWireSha256",
"omittedDerived"
],
"properties": {
"format": {
"const": "wiki-bank-case-compact/1"
},
"payload": {
"type": "object",
"description": "Original native material except derived nativeContextMarkdown. Only object occurrences in sources arrays become { $wikiBankSource: id }. Resolve complete source objects from sourcesById before inspecting citations or verifying native owner byte hashes. Preserve order and repeated occurrences."
},
"complete": {
"const": true
},
"sourcesById": {
"type": "object",
"description": "Complete source objects keyed by canonical full-object SHA plus exact JSON wire SHA. Qualifications, translations, locators, unknown fields and property order participate in identity.",
"additionalProperties": {
"type": "object"
}
},
"materialSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"omittedDerived": {
"type": "object",
"required": [
"nativeContextMarkdownSha256"
],
"properties": {
"nativeContextMarkdownSha256": {
"type": [
"string",
"null"
]
}
}
},
"materialWireSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
{
"type": "object",
"required": [
"format",
"complete",
"materialFormat",
"materialLocation",
"textPayloadSha256",
"textPayloadBytes",
"materialSha256",
"materialWireSha256",
"sourceCount"
],
"properties": {
"format": {
"const": "wiki-bank-case-text/1"
},
"complete": {
"const": true
},
"sourceCount": {
"type": "integer",
"minimum": 0
},
"materialFormat": {
"const": "wiki-bank-case-compact/1"
},
"materialSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"materialLocation": {
"const": "content[0].text"
},
"textPayloadBytes": {
"type": "integer",
"minimum": 0
},
"textPayloadSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"materialWireSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
{
"type": "object",
"required": [
"format",
"complete",
"state",
"reason",
"limitBytes",
"requiredBytes",
"requestedFormat",
"requestedTextMode",
"fullFormatLimitBytes",
"retrySameRequestUseful",
"recovery",
"message"
],
"properties": {
"state": {
"const": "held"
},
"format": {
"const": "wiki-bank-case-held/1"
},
"reason": {
"const": "response_budget_exceeded"
},
"message": {
"type": "string"
},
"complete": {
"const": false
},
"recovery": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"format",
"textMode",
"requiresStructuredContent",
"readMode",
"sameSnapshot"
],
"properties": {
"format": {
"enum": [
"json",
"full"
]
},
"readMode": {
"const": "fresh_read"
},
"textMode": {
"enum": [
"summary",
"compatible"
]
},
"sameSnapshot": {
"const": false
},
"requiresStructuredContent": {
"type": "boolean"
}
}
}
]
},
"limitBytes": {
"type": "integer"
},
"requiredBytes": {
"type": "integer"
},
"requestedFormat": {
"enum": [
"json",
"full"
]
},
"requestedTextMode": {
"enum": [
"compatible",
"summary"
]
},
"fullFormatLimitBytes": {
"type": "integer"
},
"retrySameRequestUseful": {
"const": false
}
}
},
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
}
]
}assess_bank_case annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}answer_lookup — Look up a reviewed answer with its official source
Advertised read-only
Return private.law's reviewed structured answer to a concrete question about one country, residence or citizenship programme, tax regime, bank or legal form — the statement, conditions and verbatim quotations from official sources with URLs and dates. Ask in natural language (the place must be named), or pass exact codes from answer_objects. When the question is not matched with confidence, found=false and candidates suggest known questions to clarify. Candidates are metadata only, carry no citation URL and do not establish that an answer is currently available. Pass object alone to list its known question topics. reason distinguishes invalid input, unknown public-catalog identities, a low-confidence match, the admission state of a matched topic (pinned for release, pending_native_pin, withdrawn, locale_not_covered; only a pinned topic is read) and held (a current projection hold named in hold); it never determines that no legal rule exists.
answer_lookup input schema
{
"type": "object",
"properties": {
"locale": {
"enum": [
"ru",
"en"
],
"type": "string",
"description": "Answer language; Russian when omitted."
},
"object": {
"type": "string",
"maxLength": 200,
"description": "Object code or name (optional); the question is then matched against that object only."
},
"question": {
"type": "string",
"maxLength": 2000,
"description": "A natural-language question naming the place, programme, bank or form."
},
"questionCode": {
"type": "string",
"description": "Exact question code (optional; requires object)."
}
}
}answer_lookup output schema
{
"type": "object",
"required": [
"found",
"cell",
"candidates",
"revision"
],
"properties": {
"cell": {
"anyOf": [
{
"type": "object",
"required": [
"object",
"question",
"answers",
"url",
"provenance"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"object": {
"type": "object",
"required": [
"code",
"name",
"type"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
}
}
},
"answers": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"properties": {
"temporalRecordedClauses": {
"type": "null"
}
}
},
{
"required": [
"temporalRecordedClauses",
"machineApplicability",
"valueRaw"
],
"properties": {
"valueRaw": {
"type": "null"
},
"machineApplicability": {
"const": "unknown"
}
}
}
],
"required": [
"statement",
"caveat",
"conditions",
"sources"
],
"properties": {
"ref": {
"type": "string"
},
"role": {
"type": "string"
},
"valid": {},
"value": {},
"caveat": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"quote",
"url",
"title",
"sourceDate",
"checked",
"quoteTranslation",
"verification"
],
"properties": {
"url": {
"type": "string"
},
"quote": {
"type": "string",
"description": "Verbatim text of the official source."
},
"title": {
"type": "string"
},
"checked": {
"type": "string",
"description": "Actual native date the quotation was checked in the current stored snapshot; not proof of current law."
},
"locator": {},
"language": {
"type": [
"string",
"null"
],
"description": "Language recorded for the native quotation."
},
"sourceDate": {
"type": [
"string",
"null"
],
"description": "The native source document date; null when unknown. Separate from quotation verification."
},
"sourceKind": {
"type": [
"string",
"null"
],
"description": "Native source kind; null when withheld from the public projection."
},
"sourceClass": {
"type": [
"string",
"null"
],
"description": "Normal source classification from the admitted B item."
},
"evidenceNote": {
"type": "string",
"description": "Full native explanation of the limited role of this source."
},
"evidenceRole": {
"enum": [
"provider_identity"
],
"type": "string",
"description": "Identity-only required evidence; not proof of the answer tariff or current client eligibility."
},
"verification": {
"type": "string"
},
"quoteTranslation": {
"type": [
"string",
"null"
],
"description": "Exact translation supplied by the native source record; null when absent."
},
"sourceQualification": {
"type": [
"object",
"null"
],
"description": "Source qualification from the admitted B item, when present."
},
"translationLanguage": {
"type": [
"string",
"null"
],
"description": "Language of the exact quotation translation; null when absent."
},
"verificationFingerprint": {
"type": "object",
"required": [
"version",
"snapshotRepresentation",
"snapshotSha256",
"quoteLiteralSha256",
"membershipRecipe",
"checkIdentitySha256",
"fingerprintSha256"
],
"properties": {
"version": {
"type": "integer"
},
"snapshotSha256": {
"type": "string"
},
"membershipRecipe": {
"type": "string"
},
"fingerprintSha256": {
"type": "string"
},
"quoteLiteralSha256": {
"type": "string"
},
"checkIdentitySha256": {
"type": "string"
},
"snapshotRepresentation": {
"type": "string"
}
},
"description": "Exact B source snapshot and quotation fingerprint; not current-law proof."
}
}
}
},
"valueRaw": {},
"statement": {
"type": "string"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"valueState": {
"type": "string"
},
"nativeScope": {
"type": "array"
},
"recordedText": {
"type": "string"
},
"exceptionOfRef": {
"type": [
"string",
"null"
],
"description": "Exact native parent answer reference; null when absent. No parent is inferred."
},
"machineApplicability": {},
"temporalRecordedClauses": {
"type": "object",
"required": [
"schema_version",
"status",
"machine_applicability",
"selected_value_raw",
"publication_admission",
"source_evidence_bound",
"display_note",
"source_spans",
"clauses"
],
"properties": {
"status": {
"const": "source_bound"
},
"clauses": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"duration_output"
],
"properties": {
"time_kind": {
"const": "duration"
},
"endpoint_output": {
"type": "null"
}
}
},
{
"required": [
"endpoint_output"
],
"properties": {
"time_kind": {
"const": "endpoint"
},
"duration_output": {
"type": "null"
}
}
}
],
"required": [
"id",
"evidence_span_ids",
"events",
"label",
"target",
"display",
"issuer",
"authority",
"modality_governs",
"counting",
"condition_note",
"pause_note",
"extension_note",
"applicability",
"claim_kind",
"authority_kind",
"modality_kind",
"modality_word",
"time_kind",
"scope",
"actors",
"event_targets",
"pauses",
"extensions",
"conditions",
"omitted"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": [
"string",
"null"
]
},
"scope": {
"type": "object",
"required": [
"region",
"cohort"
],
"properties": {
"cohort": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"actors": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"events": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"from": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"event": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"issuer": {
"type": [
"string",
"null"
]
},
"pauses": {
"type": "array",
"items": {
"type": "string"
}
},
"target": {
"type": [
"string",
"null"
]
},
"display": {
"type": [
"string",
"null"
]
},
"omitted": {
"type": "array",
"items": {
"type": "string"
}
},
"counting": {
"type": [
"string",
"null"
]
},
"authority": {
"type": [
"string",
"null"
]
},
"time_kind": {
"enum": [
"duration",
"endpoint"
]
},
"claim_kind": {
"enum": [
"normative_rule",
"agency_estimate",
"firm_estimate",
"validity_window",
"eligibility_requirement",
"source_event",
"not_established"
]
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"extensions": {
"type": "array",
"items": {
"type": "string"
}
},
"pause_note": {
"type": [
"string",
"null"
]
},
"applicability": {
"type": [
"string",
"null"
]
},
"event_targets": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"modality_kind": {
"enum": [
"unqualified",
"usual",
"estimate",
"not_established"
]
},
"modality_word": {
"type": [
"string",
"null"
]
},
"authority_kind": {
"enum": [
"law",
"agency_guidance",
"firm",
"not_established"
]
},
"condition_note": {
"type": [
"string",
"null"
]
},
"extension_note": {
"type": [
"string",
"null"
]
},
"duration_output": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"value",
"counting",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_duration"
},
"value": {
"anyOf": [
{
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"per": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"jurisdiction"
],
"properties": {
"kind": {
"enum": [
"calendar_year",
"tax_year"
]
},
"jurisdiction": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"length",
"anchor"
],
"properties": {
"kind": {
"enum": [
"rolling",
"preceding",
"fixed_period"
]
},
"anchor": {
"type": "string"
},
"length": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
},
"bound": {
"enum": [
"gt",
"gte",
"lt",
"lte"
]
},
"approx": {
"type": "boolean"
},
"approximate": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"unit",
"range"
],
"properties": {
"per": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"jurisdiction"
],
"properties": {
"kind": {
"enum": [
"calendar_year",
"tax_year"
]
},
"jurisdiction": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"length",
"anchor"
],
"properties": {
"kind": {
"enum": [
"rolling",
"preceding",
"fixed_period"
]
},
"anchor": {
"type": "string"
},
"length": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
},
"range": {
"type": "object",
"required": [
"from",
"to",
"from_inclusive",
"to_inclusive"
],
"properties": {
"to": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"from": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"to_inclusive": {
"type": [
"boolean",
"null"
]
},
"from_inclusive": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"range"
],
"properties": {
"range": {
"type": "object",
"required": [
"from",
"to",
"from_inclusive",
"to_inclusive"
],
"properties": {
"to": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
},
"from": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
},
"to_inclusive": {
"type": "boolean"
},
"from_inclusive": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"unbounded"
],
"properties": {
"unbounded": {
"const": true
}
},
"additionalProperties": false
}
]
},
"counting": {
"enum": [
"calendar",
"business",
"not_stated"
]
},
"stage_relation": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"stage",
"spanIds"
],
"properties": {
"kind": {
"const": "total_stage"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"stage",
"baseStage",
"spanIds"
],
"properties": {
"kind": {
"const": "additional_to"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"baseStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"value",
"duration_basis",
"counting",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_duration"
},
"value": {
"type": "null"
},
"counting": {
"enum": [
"calendar",
"business",
"not_stated"
]
},
"duration_basis": {
"type": "object",
"required": [
"kind",
"basis",
"referenceStage",
"spanIds"
],
"properties": {
"kind": {
"const": "same_actual_prior_grant"
},
"basis": {
"const": "actual_individual_grant"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"referenceStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"stage_relation": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"stage",
"spanIds"
],
"properties": {
"kind": {
"const": "total_stage"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"stage",
"baseStage",
"spanIds"
],
"properties": {
"kind": {
"const": "additional_to"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"baseStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
}
]
},
"endpoint_output": {
"type": "object",
"required": [
"kind",
"value",
"boundary",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_endpoint"
},
"value": {
"anyOf": [
{
"type": "object",
"required": [
"v"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"precision": {
"const": "day"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"v",
"precision"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}$"
},
"precision": {
"const": "year"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"v",
"precision"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$"
},
"precision": {
"const": "month"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"precision",
"month",
"day"
],
"properties": {
"day": {
"type": "integer",
"maximum": 31,
"minimum": 1
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"precision": {
"const": "annual"
}
},
"additionalProperties": false
}
]
},
"boundary": {
"enum": [
"inclusive",
"exclusive",
"not_stated"
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
},
"modality_governs": {
"type": [
"string",
"null"
]
},
"evidence_span_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
"minItems": 1
},
"display_note": {
"type": "string"
},
"source_spans": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source_index",
"text",
"text_sha256",
"snapshot_sha256",
"quote_literal_sha256",
"start_byte",
"end_byte"
],
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"end_byte": {
"type": "integer",
"minimum": 1
},
"start_byte": {
"type": "integer",
"minimum": 0
},
"text_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"source_index": {
"type": "integer",
"minimum": 0
},
"snapshot_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"quote_literal_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Per-answer source indexes and verified UTF-8 coordinates in the Native snapshot. Snapshot offsets are owner-verified; this is not current-law or personal-applicability proof."
},
"schema_version": {
"const": 1
},
"selected_value_raw": {
"type": "null"
},
"machine_applicability": {
"const": "unknown"
},
"publication_admission": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
}
}
}
},
"question": {
"type": "object",
"required": [
"code",
"text"
],
"properties": {
"code": {
"type": "string"
},
"text": {
"type": "string"
},
"unit": {
"type": "string"
}
}
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
},
"materialVersion": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Content-addressed version of this complete native cell, including all qualifications and source evidence; independent of the request revision."
}
}
},
{
"type": "null"
}
]
},
"hold": {
"type": "string",
"description": "projection hold reason when reason is held; metadata, not legal content"
},
"mode": {
"enum": [
"questions"
],
"type": "string"
},
"found": {
"type": "boolean"
},
"object": {
"type": "object"
},
"reason": {
"type": "string",
"description": "One of available, held, pending_native_pin, withdrawn, locale_not_covered, no_answer, unavailable, unknown_object, unknown_question, invalid_input, unsupported_locale, question_required, question_list_too_large, ambiguous_object, low_confidence, no_match."
},
"message": {
"type": "string"
},
"revision": {
"type": "string",
"description": "Request/projection revision; distinct from cell.materialVersion and provenance.version."
},
"questions": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"text",
"admission"
],
"properties": {
"code": {
"type": "string"
},
"text": {
"type": "string"
},
"admission": {
"enum": [
"pinned",
"pending_native_pin",
"withdrawn",
"locale_not_covered"
],
"type": "string",
"description": "Release admission of the topic: pinned (current native-content pin plus reference-scope pin), pending a native pin, withdrawn, or not covered in this locale. Not evidence that an answer is currently available."
}
}
},
"maxItems": 64
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"object",
"question",
"text",
"admission"
],
"properties": {
"text": {
"type": "string"
},
"object": {
"type": "string"
},
"question": {
"type": "string"
},
"admission": {
"enum": [
"pinned",
"pending_native_pin",
"withdrawn",
"locale_not_covered"
],
"type": "string",
"description": "Release admission of the topic: pinned (current native-content pin plus reference-scope pin), pending a native pin, withdrawn, or not covered in this locale. Not evidence that an answer is currently available."
}
}
}
},
"reasonScope": {
"enum": [
"reviewed_public_catalog"
],
"type": "string"
}
}
}answer_lookup annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}answer_compare — Compare reviewed answers across places
Advertised read-only
Return the reviewed answers to one question for several objects side by side (for example the minimum investment of several programmes, or a tax rate in several countries), each with its official quotations. Objects not covered are listed in missing — never guessed. Aliases count once; at least two distinct recognised objects are required. coverage describes answer availability for this request only, not completeness of law or personal applicability. Display missing objects and the coverage note when presenting partial results.
answer_compare input schema
{
"type": "object",
"required": [
"question",
"objects"
],
"properties": {
"locale": {
"enum": [
"ru",
"en"
],
"type": "string",
"description": "Answer language; Russian when omitted."
},
"objects": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 10,
"minItems": 2,
"description": "Object codes or names."
},
"question": {
"type": "string",
"maxLength": 2000,
"description": "A question code or a natural-language question."
}
}
}answer_compare output schema
{
"type": "object",
"required": [
"question",
"rows",
"missing",
"revision"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"object",
"question",
"answers",
"url",
"provenance"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"object": {
"type": "object",
"required": [
"code",
"name",
"type"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
}
}
},
"answers": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"properties": {
"temporalRecordedClauses": {
"type": "null"
}
}
},
{
"required": [
"temporalRecordedClauses",
"machineApplicability",
"valueRaw"
],
"properties": {
"valueRaw": {
"type": "null"
},
"machineApplicability": {
"const": "unknown"
}
}
}
],
"required": [
"statement",
"caveat",
"conditions",
"sources"
],
"properties": {
"ref": {
"type": "string"
},
"role": {
"type": "string"
},
"valid": {},
"value": {},
"caveat": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"quote",
"url",
"title",
"sourceDate",
"checked",
"quoteTranslation",
"verification"
],
"properties": {
"url": {
"type": "string"
},
"quote": {
"type": "string",
"description": "Verbatim text of the official source."
},
"title": {
"type": "string"
},
"checked": {
"type": "string",
"description": "Actual native date the quotation was checked in the current stored snapshot; not proof of current law."
},
"locator": {},
"language": {
"type": [
"string",
"null"
],
"description": "Language recorded for the native quotation."
},
"sourceDate": {
"type": [
"string",
"null"
],
"description": "The native source document date; null when unknown. Separate from quotation verification."
},
"sourceKind": {
"type": [
"string",
"null"
],
"description": "Native source kind; null when withheld from the public projection."
},
"sourceClass": {
"type": [
"string",
"null"
],
"description": "Normal source classification from the admitted B item."
},
"evidenceNote": {
"type": "string",
"description": "Full native explanation of the limited role of this source."
},
"evidenceRole": {
"enum": [
"provider_identity"
],
"type": "string",
"description": "Identity-only required evidence; not proof of the answer tariff or current client eligibility."
},
"verification": {
"type": "string"
},
"quoteTranslation": {
"type": [
"string",
"null"
],
"description": "Exact translation supplied by the native source record; null when absent."
},
"sourceQualification": {
"type": [
"object",
"null"
],
"description": "Source qualification from the admitted B item, when present."
},
"translationLanguage": {
"type": [
"string",
"null"
],
"description": "Language of the exact quotation translation; null when absent."
},
"verificationFingerprint": {
"type": "object",
"required": [
"version",
"snapshotRepresentation",
"snapshotSha256",
"quoteLiteralSha256",
"membershipRecipe",
"checkIdentitySha256",
"fingerprintSha256"
],
"properties": {
"version": {
"type": "integer"
},
"snapshotSha256": {
"type": "string"
},
"membershipRecipe": {
"type": "string"
},
"fingerprintSha256": {
"type": "string"
},
"quoteLiteralSha256": {
"type": "string"
},
"checkIdentitySha256": {
"type": "string"
},
"snapshotRepresentation": {
"type": "string"
}
},
"description": "Exact B source snapshot and quotation fingerprint; not current-law proof."
}
}
}
},
"valueRaw": {},
"statement": {
"type": "string"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"valueState": {
"type": "string"
},
"nativeScope": {
"type": "array"
},
"recordedText": {
"type": "string"
},
"exceptionOfRef": {
"type": [
"string",
"null"
],
"description": "Exact native parent answer reference; null when absent. No parent is inferred."
},
"machineApplicability": {},
"temporalRecordedClauses": {
"type": "object",
"required": [
"schema_version",
"status",
"machine_applicability",
"selected_value_raw",
"publication_admission",
"source_evidence_bound",
"display_note",
"source_spans",
"clauses"
],
"properties": {
"status": {
"const": "source_bound"
},
"clauses": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"duration_output"
],
"properties": {
"time_kind": {
"const": "duration"
},
"endpoint_output": {
"type": "null"
}
}
},
{
"required": [
"endpoint_output"
],
"properties": {
"time_kind": {
"const": "endpoint"
},
"duration_output": {
"type": "null"
}
}
}
],
"required": [
"id",
"evidence_span_ids",
"events",
"label",
"target",
"display",
"issuer",
"authority",
"modality_governs",
"counting",
"condition_note",
"pause_note",
"extension_note",
"applicability",
"claim_kind",
"authority_kind",
"modality_kind",
"modality_word",
"time_kind",
"scope",
"actors",
"event_targets",
"pauses",
"extensions",
"conditions",
"omitted"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": [
"string",
"null"
]
},
"scope": {
"type": "object",
"required": [
"region",
"cohort"
],
"properties": {
"cohort": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"actors": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"events": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"from": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"event": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"issuer": {
"type": [
"string",
"null"
]
},
"pauses": {
"type": "array",
"items": {
"type": "string"
}
},
"target": {
"type": [
"string",
"null"
]
},
"display": {
"type": [
"string",
"null"
]
},
"omitted": {
"type": "array",
"items": {
"type": "string"
}
},
"counting": {
"type": [
"string",
"null"
]
},
"authority": {
"type": [
"string",
"null"
]
},
"time_kind": {
"enum": [
"duration",
"endpoint"
]
},
"claim_kind": {
"enum": [
"normative_rule",
"agency_estimate",
"firm_estimate",
"validity_window",
"eligibility_requirement",
"source_event",
"not_established"
]
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"extensions": {
"type": "array",
"items": {
"type": "string"
}
},
"pause_note": {
"type": [
"string",
"null"
]
},
"applicability": {
"type": [
"string",
"null"
]
},
"event_targets": {
"type": "object",
"required": [
"from",
"to",
"event"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"from": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"modality_kind": {
"enum": [
"unqualified",
"usual",
"estimate",
"not_established"
]
},
"modality_word": {
"type": [
"string",
"null"
]
},
"authority_kind": {
"enum": [
"law",
"agency_guidance",
"firm",
"not_established"
]
},
"condition_note": {
"type": [
"string",
"null"
]
},
"extension_note": {
"type": [
"string",
"null"
]
},
"duration_output": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"value",
"counting",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_duration"
},
"value": {
"anyOf": [
{
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"per": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"jurisdiction"
],
"properties": {
"kind": {
"enum": [
"calendar_year",
"tax_year"
]
},
"jurisdiction": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"length",
"anchor"
],
"properties": {
"kind": {
"enum": [
"rolling",
"preceding",
"fixed_period"
]
},
"anchor": {
"type": "string"
},
"length": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
},
"bound": {
"enum": [
"gt",
"gte",
"lt",
"lte"
]
},
"approx": {
"type": "boolean"
},
"approximate": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"unit",
"range"
],
"properties": {
"per": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"jurisdiction"
],
"properties": {
"kind": {
"enum": [
"calendar_year",
"tax_year"
]
},
"jurisdiction": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"length",
"anchor"
],
"properties": {
"kind": {
"enum": [
"rolling",
"preceding",
"fixed_period"
]
},
"anchor": {
"type": "string"
},
"length": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
},
"range": {
"type": "object",
"required": [
"from",
"to",
"from_inclusive",
"to_inclusive"
],
"properties": {
"to": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"from": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"to_inclusive": {
"type": [
"boolean",
"null"
]
},
"from_inclusive": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"range"
],
"properties": {
"range": {
"type": "object",
"required": [
"from",
"to",
"from_inclusive",
"to_inclusive"
],
"properties": {
"to": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
},
"from": {
"type": "object",
"required": [
"v",
"unit"
],
"properties": {
"v": {
"type": "integer",
"minimum": 0
},
"unit": {
"enum": [
"second",
"hour",
"day",
"week",
"month",
"year",
"business_day",
"tax_year",
"tax_period"
],
"type": "string"
}
},
"additionalProperties": false
},
"to_inclusive": {
"type": "boolean"
},
"from_inclusive": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"unbounded"
],
"properties": {
"unbounded": {
"const": true
}
},
"additionalProperties": false
}
]
},
"counting": {
"enum": [
"calendar",
"business",
"not_stated"
]
},
"stage_relation": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"stage",
"spanIds"
],
"properties": {
"kind": {
"const": "total_stage"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"stage",
"baseStage",
"spanIds"
],
"properties": {
"kind": {
"const": "additional_to"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"baseStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"value",
"duration_basis",
"counting",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_duration"
},
"value": {
"type": "null"
},
"counting": {
"enum": [
"calendar",
"business",
"not_stated"
]
},
"duration_basis": {
"type": "object",
"required": [
"kind",
"basis",
"referenceStage",
"spanIds"
],
"properties": {
"kind": {
"const": "same_actual_prior_grant"
},
"basis": {
"const": "actual_individual_grant"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"referenceStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"stage_relation": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"stage",
"spanIds"
],
"properties": {
"kind": {
"const": "total_stage"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"stage",
"baseStage",
"spanIds"
],
"properties": {
"kind": {
"const": "additional_to"
},
"stage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"baseStage": {
"type": "object",
"required": [
"code",
"label"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "object",
"required": [
"ru",
"en",
"spanIds"
],
"properties": {
"en": {
"type": "string"
},
"ru": {
"type": "string"
},
"spanIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
}
]
},
"endpoint_output": {
"type": "object",
"required": [
"kind",
"value",
"boundary",
"scalar_applicability",
"source_evidence_bound"
],
"properties": {
"kind": {
"const": "recorded_source_endpoint"
},
"value": {
"anyOf": [
{
"type": "object",
"required": [
"v"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"precision": {
"const": "day"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"v",
"precision"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}$"
},
"precision": {
"const": "year"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"v",
"precision"
],
"properties": {
"v": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$"
},
"precision": {
"const": "month"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"precision",
"month",
"day"
],
"properties": {
"day": {
"type": "integer",
"maximum": 31,
"minimum": 1
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"precision": {
"const": "annual"
}
},
"additionalProperties": false
}
]
},
"boundary": {
"enum": [
"inclusive",
"exclusive",
"not_stated"
]
},
"scalar_applicability": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
},
"modality_governs": {
"type": [
"string",
"null"
]
},
"evidence_span_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
},
"minItems": 1
},
"display_note": {
"type": "string"
},
"source_spans": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source_index",
"text",
"text_sha256",
"snapshot_sha256",
"quote_literal_sha256",
"start_byte",
"end_byte"
],
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"end_byte": {
"type": "integer",
"minimum": 1
},
"start_byte": {
"type": "integer",
"minimum": 0
},
"text_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"source_index": {
"type": "integer",
"minimum": 0
},
"snapshot_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"quote_literal_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Per-answer source indexes and verified UTF-8 coordinates in the Native snapshot. Snapshot offsets are owner-verified; this is not current-law or personal-applicability proof."
},
"schema_version": {
"const": 1
},
"selected_value_raw": {
"type": "null"
},
"machine_applicability": {
"const": "unknown"
},
"publication_admission": {
"const": false
},
"source_evidence_bound": {
"const": true
}
},
"additionalProperties": false
}
}
}
},
"question": {
"type": "object",
"required": [
"code",
"text"
],
"properties": {
"code": {
"type": "string"
},
"text": {
"type": "string"
},
"unit": {
"type": "string"
}
}
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
},
"materialVersion": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Content-addressed version of this complete native cell, including all qualifications and source evidence; independent of the request revision."
}
}
}
},
"reason": {
"type": "string"
},
"missing": {
"type": "array",
"items": {
"type": "string"
}
},
"coverage": {
"type": "object",
"required": [
"status",
"requestedCount",
"availableCount",
"note"
],
"properties": {
"note": {
"type": "string"
},
"status": {
"enum": [
"all_requested_available",
"partial",
"unavailable"
],
"type": "string"
},
"availableCount": {
"type": "integer",
"minimum": 0
},
"requestedCount": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"description": "Request availability only. A null denominator means identities could not be resolved."
},
"noAnswer": {
"type": "array",
"items": {
"type": "string"
},
"description": "Recognised requested objects without a currently available whole reviewed answer."
},
"question": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"text"
],
"properties": {
"code": {
"type": "string"
},
"text": {
"type": "string"
}
}
},
{
"type": "null"
}
]
},
"revision": {
"type": "string"
},
"reasonScope": {
"type": "string"
},
"unknownObjects": {
"type": "array",
"items": {
"type": "string"
},
"description": "Unrecognised identities within the reviewed public catalogue; not a statement about all legal entities."
}
}
}answer_compare annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}answer_objects — List reviewed native topics
Advertised read-only
Enumerate active reviewed topic identities, including topics whose answers are currently held. A topic has at least one current native-content and reference-scope pin in the requested locale. reviewedQuestionCount counts these mapped questions; it is coverage, not current answer availability. Each object also carries answerCount: distinct questions with a currently available whole answer in the requested locale, counted over pinned cells (current native-content pin plus reference-scope pin), not variants, sources or articles. Held cells, including native_public_scope_held, are excluded from counts rather than failing the page. Limit is an upper bound: counted pages emit at most 4 objects and at most 64 candidate pairs, both over pinned cells only. Follow nextCursor until null; total counts matching reviewed topics, not answers. Only the selected page's answers are read. A completed source or policy hold can yield answerCount:0 without erasing the topic. Counts are observed in one read-only snapshot per page at countObservedAt; pages are not one shared snapshot. Invalid cursors return an error; only operational failures (projection resource caps, a stale or mismatched snapshot, a read error) return {error, reason: count_unavailable}, never partial or stale numbers. A pin does not establish current law or personal applicability.
answer_objects input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Filter by object type, e.g. state, program, regime, bank, legal_form."
},
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Requested upper bound; default 100, maximum 250. Counted pages return at most 4 objects and may be shorter to respect the 64 candidate-pair budget over pinned cells; follow nextCursor."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor: the exact nextCursor returned by the previous call. Omit for the first page."
},
"locale": {
"enum": [
"ru",
"en"
],
"type": "string",
"description": "Answer language; Russian when omitted."
}
}
}answer_objects output schema
{
"type": "object",
"anyOf": [
{
"required": [
"objects",
"total",
"nextCursor",
"revision",
"countObservedAt"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string"
},
"total": {
"type": "integer",
"description": "Every active reviewed topic matching the type filter, including currently held topics, across all pages."
},
"reason": {
"type": "string"
},
"objects": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"type",
"url",
"provenance",
"answerCount",
"reviewedQuestionCount"
],
"properties": {
"url": {
"type": "string"
},
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"provenance": {
"type": "object",
"required": [
"contract",
"id",
"canonical_url",
"publisher",
"version",
"cite_as",
"primary_sources",
"verification_status"
],
"properties": {
"id": {
"type": "string",
"description": "<locale>:<slug> for an article, <dataset>:<record id> for a dataset row."
},
"cite_as": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
],
"description": "Revision of exactly the material served: for an article the snapshot content hash (the HTML ETag value); for a dataset record the dataset revision it was published in, not the published filename. Null when unknown."
},
"contract": {
"type": "string",
"const": "wiki-provenance/1"
},
"publisher": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"canonical_url": {
"type": "string",
"format": "uri",
"description": "Published location without tracking parameters."
},
"primary_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
}
}
},
"verification_status": {
"enum": [
"verified",
"pending",
"unknown"
],
"type": "string"
}
},
"description": "Origin of one record: stable id, clean canonical URL, publisher, the exact published revision served, a ready citation, primary sources and review status."
},
"answerCount": {
"type": "integer",
"minimum": 0,
"description": "Currently available whole question cells in this locale; zero means every reviewed cell is held."
},
"reviewedQuestionCount": {
"type": "integer",
"minimum": 1,
"description": "Distinct current questions with reviewed native-content and reference-scope pins; this is mapped coverage, not availability."
}
}
}
},
"revision": {
"type": "string"
},
"nextCursor": {
"type": [
"string",
"null"
],
"description": "Pass as cursor for the next page; null on the last page."
},
"countObservedAt": {
"type": "string"
}
}
}answer_objects annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1281 ms
- 95th percentile latency
- 1281 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1281 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http private-law-wiki-mcp https://wiki.private.law/mcpCodex
Codex configuration
codex mcp add private-law-wiki-mcp --url https://wiki.private.law/mcpCursor
Cursor configuration
{
"mcpServers": {
"private-law-wiki-mcp": {
"url": "https://wiki.private.law/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"private-law-wiki-mcp": {
"type": "streamableHttp",
"url": "https://wiki.private.law/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"private-law-wiki-mcp": {
"type": "http",
"url": "https://wiki.private.law/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http private-law-wiki-mcp https://wiki.private.law/mcpClaude Desktop
Claude Desktop configuration
https://wiki.private.law/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"private-law-wiki-mcp": {
"serverUrl": "https://wiki.private.law/mcp"
}
}
}Let your agent find its tools
Find servers like Private Law Wiki MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.