Servers Playground How we check Add a server Log in

BGB (Germany)

Working · 18 ms

io.arxo/de-bgbv0.1.9 Domain verified

German Civil Code (BGB) as executable rules: periods, deadlines and more, answered with grounds

Legal & Government

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.arxo.io/mcp/de-bgb

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

law_answer_capabilities Read-only

A machine-readable matrix of the Lens producers that are actually installed, of replay/projection checks, profiles, limits and the contract tests that confirm them. declared_only means a schema with no executable witness.

This tool takes no arguments.

BGB (Germany) MCP server | mcptry

Tools (20)

law_answer_capabilities

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "additionalProperties": false
}

law_argue

How robust a conclusion is: the map of the dispute under the argumentation profile §274 (DECISION-0039). The answer falls into four classes: SKEPTICALLY_ACCEPTED — the conclusion is invulnerable (it survives in the grounded extension); CREDULOUSLY_ACCEPTED — merely defensible (there is a position for it and a position against); REJECTED — it survives nowhere; NO_ARGUMENT — there are no arguments at all. It builds ALL arguments out of the facts and the rules of the instrument (chains that did not fire in ordinary inference included), the rebut/undermine/undercut attacks and the defeats by priority. Predicate names come from law_packages. On large instruments a refusal by cap is possible — narrow facts or raise limits.maxArguments.

read-only

Argument	Type	Description
args	array	the arguments of the predicate
facts	array	facts of the case: [{predicate, args, negated?, provenance?}]. provenance is the same object as on law_ask: origin, document, quote, extractor. confidence is read by the package EvidencePolicy, not by the engine
limits	object	the caps of the §274 profile: maxArguments (64), maxExtensions (8), maxUndecided (16)
package	string	narrow the question to one package of law
legalTime	string	the date of the law (YYYY-MM-DD)
predicate*	string	the conclusion whose robustness is being measured

Input schema (JSON)

{
  "type": "object",
  "required": [
    "predicate"
  ],
  "properties": {
    "args": {
      "type": "array",
      "description": "the arguments of the predicate"
    },
    "facts": {
      "type": "array",
      "description": "facts of the case: [{predicate, args, negated?, provenance?}]. provenance is the same object as on law_ask: origin, document, quote, extractor. confidence is read by the package EvidencePolicy, not by the engine"
    },
    "limits": {
      "type": "object",
      "description": "the caps of the §274 profile: maxArguments (64), maxExtensions (8), maxUndecided (16)"
    },
    "package": {
      "type": "string",
      "description": "narrow the question to one package of law"
    },
    "legalTime": {
      "type": "string",
      "description": "the date of the law (YYYY-MM-DD)"
    },
    "predicate": {
      "type": "string",
      "description": "the conclusion whose robustness is being measured"
    }
  },
  "additionalProperties": false
}

law_ask

Put a question to formalised law. When the answer is "not established" it carries whyNot — the engine's why_not report §185: the candidate rules and the state of every conjunct (satisfied / not satisfied / undetermined); the missing facts are visible there and need not be guessed. BEFORE THE FIRST call obtain the predicate names through law_search (a question in your own words → addresses) or law_packages (the signatures of a known instrument) — an invented name will be rejected. If the tool returned an error or "not established", THAT IS THE ANSWER: pass it to the user and do not substitute general knowledge about the law of some other country. But "I found no suitable instrument" is NOT an answer until law_search has been asked: silence of the catalogue is a property of searching by title, not a conclusion about the corpus. kind='truth' — whether a fact is established (the answer follows §62: established / refuted / contradiction / not established); kind='collect' — enumerate the records; kind='deadline' — compute a time limit on the official calendar; kind='positions' — which DUTIES arose from the facts and what their statuses are (active / fulfilled / violated, §134–§138); kind='why_not' — the why_not report §185 on the same goal, whatever the status of the answer. The answer carries the rules applied, the warnings and the provenance with hashes; truth/collect also carry a signature block (parameter types, the closure of types, constants; DECISION-0139) for presentation. The server does not guess: where a norm is not formalised, the answer is "not established" or an error.

read-only

Argument	Type	Description
args	array	the arguments of the predicate in the order of its signature; with kind='collect' exactly one of them is the selection variable ?name (for example ['urn:x:water', 'urn:x:mix', '?value']), the rest are values. Values follow the parameter type: an entity — 'urn:…' or a short name; Date — 'YYYY-MM-DD'; Money — '<number> <currency>' ('43250 KZT'); Quantity — '<number> <unit>' with the unit exactly as the package spells it ('25 calendar_year', '30 meter'; law_packages shows the units of the constants, units are never converted — §49); a constant of the package — its name

law_capture_answer

Run a registered producer and obtain producerControl/0.2 for a later verifiable preparation of a Lens. The producer is chosen only from the shipped registry.

read-only

Argument	Type	Description
request*	object
producer*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "producer",
    "request"
  ],
  "properties": {
    "request": {
      "type": "object"
    },
    "producer": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

law_case_ask

Die Operation ask §168.4 (DECISION-0165, DECISION-0399): eine registrierte Sache eines Fallpakets über ihren verankerten Abhängigkeiten ausführen und das kanonische Auswertungsdokument mit Beweis und Manifest zurückgeben. Die Frage ist JSON nach query.schema.json (query), eine evaluate-Zeichenkette (evaluate + queryId), eine gespeicherte queryId ohne query oder card + args. Eine Verweigerung der Vorbereitung ist ein Fehler mit LDC-*-Code, nie eine leere Antwort.

read-only

Argument	Type	Description
args	object	die Kartenparameter: Name → Zeichenkettenausdruck der Sprache
card	string	die id einer Karte eines installierten Katalogs DECISION-0190
case	string	the name of the case declaration from [[cases]]; optional when there is only one case
query	object	the question as JSON per query.schema.json; queryId is a URN in the namespace of the package, or a short name given in queryId
package*	string	the path to the case package (the directory holding law.toml) from the root of the repository
queryId	string	ohne query/evaluate — die Wahl einer gespeicherten queries/*.json nach Kurzname oder voller URN; mit evaluate — die id der ausgeführten Frage
evaluate

law_editions

The axis of editions (O-2): what changed in an instrument between two dates of the law — the state of the editions, the dating of the norms and the semantic diff §215 between the D1 projections. The verdict NOT_DATED means "there was nothing to date it by", not "nothing changed". The outcome of a particular question on a date comes from law_ask with legalTime.

read-only

Argument	Type	Description
dateA*	string	the date of the law "before" (YYYY-MM-DD)
dateB*	string	the date of the law "after" (YYYY-MM-DD)
package*	string	the instrument of the corpus

Input schema (JSON)

{
  "type": "object",
  "required": [
    "package",
    "dateA",
    "dateB"
  ],
  "properties": {
    "dateA": {
      "type": "string",
      "description": "the date of the law \"before\" (YYYY-MM-DD)"
    },
    "dateB": {
      "type": "string",
      "description": "the date of the law \"after\" (YYYY-MM-DD)"
    },
    "package": {
      "type": "string",
      "description": "the instrument of the corpus"
    }
  },
  "additionalProperties": false
}

law_explain

Unfold the proof of a law_ask answer into a chain "rule ← premises → conclusion". The compact input: question (the original law_ask arguments, truth/collect), resultHash and codeHash from the provenance of the answer. The server repeats the computation and compares the hashes; if anything changed it refuses explicitly. Alternatively pass the evaluation from law_ask(proof=true). answerResource=fullAnswer.uri explains a stored compact snapshot without recomputing and without the client loading pages; by default only the proofRef chain. nodeId selects one node and all of its premises (up to 24 KB, otherwise an explicit refusal). proofHash refers to the whole graph; scope marks the part selected.

read-only

Argument	Type	Description
nodeId	string
codeHash	string
question	object	the original law_ask arguments
evaluation	object	the evaluation document from law_ask
resultHash	string
answerResource	string	the fullAnswer.uri of a stored answer taken with proof=true

Input schema (JSON)

{
  "type": "object",
  "oneOf": [
    {
      "not": {
        "anyOf": [
          {
            "required": [
              "question"
            ]
          },
          {
            "required": [
              "answerResource"
            ]
          }
        ]
      },
      "required": [
        "evaluation"
      ]
    },
    {
      "not": {
        "anyOf": [
          {
            "required": [
              "evaluation"
            ]
          },
          {
            "required": [
              "answerResource"
            ]
          }
        ]
      },
      "required": [
        "question",
        "resultHash",
        "codeHash"
      ]
    },
    {
      "not": {
        "anyOf": [
          {
            "required": [
              "evaluation"
            ]
          },
          {
            "required": [
              "question"
            ]
          },
          {
            "required": [
              "resultHash"
            ]
          },
          {
            "required": [
              "codeHash"
            ]
          }
        ]
      },
      "required": [
        "answerResource"
      ]
    }
  ],
  "properties": {
    "nodeId": {
      "type": "string",
      "minLength": 1
    },
    "codeHash": {
      "type": "string"
    },
    "question": {
      "type": "object",
      "description": "the original law_ask arguments"
    },
    "evaluation": {
      "type": "object",
      "description": "the evaluation document from law_ask"
    },
    "resultHash": {
      "type": "string"
    },
    "answerResource": {
      "type": "string",
      "description": "the fullAnswer.uri of a stored answer taken with proof=true"
    }
  },
  "additionalProperties": false
}

law_packages

The catalogue of formalised law: instruments, predicates with signatures, the boundaries of coverage. This is where the NAMES of predicates come from — they must never be guessed. But do NOT start from the catalogue when looking for the right instrument: the overview is large, and the title of an instrument rarely matches the words of a question ("Newton's laws of motion" contains no word "physics"). A question in your own words goes to law_search first, which returns addresses; the catalogue is for the exact signature of what you found. With no arguments — the overview: one line per instrument (key, title, legal order, counters of rules, facts, signatures, norms, constants); a whole instrument — package="kz-gpk"; a search over the signatures, labels and constants of every instrument — query="substring". All three modes are PAGED: limit and offset, with the remainder named in the text (`showing a–b of N; k more`) and in structuredContent (total, truncated, next — a ready-made continuation call). The unit of a page is named by pageUnit: the overview and query page over INSTRUMENTS (20 and 20 by default), package=… pages over the SIGNATURES of one instrument (20 by default, 300 at most) — large codes carry thousands. package=… together with catalog=… pages a separate list of the instrument: "questions" — the CATALOGUE OF QUESTIONS (DECISION-0190): which enquiries are provided for (a question in words, a form, a predicate or norms) and what the instrument does NOT answer, with the type of reason; a card is a template of an enquiry, not an answer, and not every instrument has one; "norms" — the NORMS of the instrument (modality §107 and label), "constants" — the CONSTANTS (names of declarations). "task-guides" — TASK GUIDES (DECISION-0414): the order of applying a canon to a document — what to gather, which cards to ask and how to read the answers; a guide answers nothing. catalog="task-guides" is allowed without package too — every guide of the profile; guide=… — the detail of one guide; the walkthrough — MCP Prompts under the same name. The detail of an instrument prints a preview of these lists and names the count and the ready-made call for the mode.

read-only

Argument	Type	Description

law_passport

Passport of an exact release: purpose, interface, boundaries, checks and performance. The reports section holds the history of measurements, failures included. Entries are paged by JSON Pointer; next continues the answer.

read-only

Argument	Type	Description
name*	string
limit	integer
offset	integer
version*	string
sections	array
contentHash*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name",
    "version",
    "contentHash"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    },
    "version": {
      "type": "string"
    },
    "sections": {
      "type": "array",
      "items": {
        "enum": [
          "description",
          "interface",
          "semantics",
          "sources",
          "composition",
          "dependencies",
          "checks",
          "evidence",
          "reports"
        ]
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "contentHash": {
      "type": "string",
      "pattern": "^sha256:[0-9a-f]{64}$"
    }
  },
  "additionalProperties": false
}

law_prepare_answer

At the explicit request of the user, repeat between 1 and 12 earlier law_ask or law_process_run calls (the course of a case, DECISION-0160), compare their replayControl strictly, and prepare a non-public frozen document for 24 hours. The client never supplies the machine answer: the server obtains it only by executing afresh. A divergence in any input, in the law, in a resource, in the server code, in the engine library or in the result rejects the document as a whole.

Argument	Type	Description
language	any
question*	string
assistant	object
calculations	array
producerRuns	array	Runs of registered producers with control/0.2; mutually exclusive with calculations.
documentVersion	any	Version of the immutable document; 0.1 is kept for transitional compatibility, 0.2 includes all native results and the common reader.

Input schema (JSON)

{
  "type": "object",
  "oneOf": [
    {
      "not": {
        "required": [
          "producerRuns"
        ]
      },
      "required": [
        "calculations"
      ]
    },
    {
      "not": {
        "required": [
          "calculations"
        ]
      },
      "required": [
        "producerRuns"
      ]
    }
  ],
  "required": [
    "question"
  ],
  "properties": {
    "language": {
      "enum": [
        "ru",
        "en"
      ]
    },
    "question": {
      "type": "string",
      "maxLength": 8000
    },
    "assistant": {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string",
          "maxLength": 12000
        },
        "explanations": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "text",
              "calculationRefs"
            ],
            "properties": {
              "text": {
                "type": "string",
                "maxLength": 12000
              },
              "calculationRefs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          },
          "maxItems": 48
        }
      },
      "additionalProperties": false
    },
    "calculations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "request",
          "replayControl"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 80
          },
          "label": {
            "type": "string",
            "maxLength": 300
          },
          "request": {
            "type": "object"
          },
          "replayControl": {
            "type": "object"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 12,
      "minItems": 1
    },
    "producerRuns": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "producer",
          "request",
          "control"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 80
          },
          "text": {
            "type": "string"
          },
          "label": {
            "type": "string",
            "maxLength": 300
          },
          "control": {
            "type": "object"
          },
          "request": {
            "type": "object"
          },
          "producer": {
            "type": "string"
          },
          "executionContext": {
            "type": "object"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 12,
      "minItems": 1,
      "description": "Runs of registered producers with control/0.2; mutually exclusive with calculations."
    },
    "documentVersion": {
      "enum": [
        "law.answers.document/0.1",
        "law.answers.document/0.2"
      ],
      "description": "Version of the immutable document; 0.1 is kept for transitional compatibility, 0.2 includes all native results and the common reader."
    }
  },
  "additionalProperties": false
}

law_process

Which stages the procedure established by an instrument consists of, and whether it carries a structural defect (O-5, DECISION-0052). The stages, the transitions and the condition of every transition are reconstructed from the formalisation rather than retold: what leads from where to where, and under what condition. The check of the graph: unreachable stages, dead transitions, a transition that enters no stage at all. Without package — the list of instruments whose procedure is formalised. A stage with no exit is named but is NOT counted as a defect: whether it is terminal by design cannot be seen from the formalisation.

read-only

Argument	Type	Description
package	string	the instrument; without it — the list of instruments that carry procedures

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "package": {
      "type": "string",
      "description": "the instrument; without it — the list of instruments that carry procedures"
    }
  },
  "additionalProperties": false
}

law_process_run

How a particular case will run, step by step (O-5, DECISION-0052): a log of {date, attempt?, facts?} is executed frame by frame, and the law of each frame is the law of ITS date. The answer says: which stages have been entered; which attempted transition produced NO legal effect (§164 — "the act was performed but did not take place"); which duties are violated and which time limits are running; what is available next and WHAT EXACTLY is missing for the rest. The names of transitions come from law_process. Stages entered means "was it ever entered", not "where it is now": the core 0.1 does not compute points of the current state.

read-only

Argument	Type	Description
steps*	array	the log of the case: [{date, attempt?, time?, decisionTime?, knowledgeTime?, facts: [{predicate, args}]}]; on an attempted transition `time` is the instant of the event (ISO 8601 with an offset), and by it the bearer takes its place in the history §161.1 (DECISION-0156); the decision and knowledge axes of a frame come from the entry, else from the case, else from midnight UTC of the date; every frame names the axes it used and where they came from
package*	string	the instrument
instance*	string	what is going through the procedure: the number of the lot, of the application, of the case
legalTime	string	the base date (YYYY-MM-DD); the date of a frame is set by the step itself
probeTime

law_publish_answer

Publish a prepared document. Repeating it with the same preparationId idempotently returns the same URL and the same separate revocation secret.

Argument	Type	Description
preparationId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "preparationId"
  ],
  "properties": {
    "preparationId": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

law_query

Eine deterministische LawQL-Abfrage über das CLIR einer Formalisierung: eine Frage an das Modell des Aktes selbst, nicht an einen Fall. Relationen: nodes(id,kind,package,package_name,path), edges(from,to,role), anchors(node,anchor,act,locator,path), labels(node,lang,text,status), fields(node,field,value,value_kind), rules(id,strength,head_predicate,head_polarity,head_variables,body_variables,body_predicates), norms(id,modality,goal_kind,condition_predicates), positions(norm,kind,bearer_type), windows(norm,kind,deadline), imports(package,imported,semantic_hash), links(from,to,kind: imports|alias|subtype|produces|reads|anchored), literals(node,context,predicate,polarity), variables(node,context,name,type), interpretations(id,predicate,role). Funktionen: anchor, labels, short, contains, overlaps, starts_with, ends_with, position, derivation; exists/not exists über eine gebundene Variable; nur Gleichheit und Mitgliedschaft, keine Arithmetik und keine Ordnungsvergleiche. Bereich: corpus nach package.name (zum Beispiel kz.corpus.labour_code, kein Dateiname) oder ein Glob; ohne corpus der gesamte Profilausschnitt; ein Bereich außerhalb des Profils ist leer (CORPUS_EMPTY). Beispiele: `from r in rules where r.head_predicate == "urn:…#eligible" select r.id as producer, r.strength as strength, anchor(r.id) as anchors` — wer erzeugt; `from l in literals where l.predicate == "urn:…#eligible" select l.node as reader, l.context as context` — wer liest; `query eligible over "pkg" { for x: Person; where applicant(x); select eligible(x); }` — Inferenz durch den Kern. Dies ist Orchestrierung über CLIR und Kern; neue juristische Semantik wird hier nicht implementiert. Statt Text eine Frage aus dem Katalog mit arguments: producers, readers, anchors-of, imports-of, links-of, type-step (die Parameter predicate/node/type sind URNs, pkg ein package.name oder ein Glob). Die strukturelle Antwort ist eine queryPage: resultHash des vollständigen queryResult, snapshot (Hash der Paketliste des Bereichs), rowCount, rows nach rowLimit (20, höchstens 5000) und rowOffset, next mit dem snapshot zur Fortsetzung; full: true liefert das vollständige queryResult, wenn der Bereich ein einzelnes Paket ist. Jede Zeile trägt ihre Provenienz (CLIR-Knoten); eine leere Antwort trägt den Explain-Trichter (emptyAt nennt die Klausel); Fehler tragen LDC-Qxxxx-Codes mit Hinweisen; ein zu breites Quellenprodukt wird vor der Ausführung abgelehnt (QUERY_TOO_BROAD), eine Fortsetzung auf einem anderen Schnappschuss als SNAPSHOT_CHANGED.

read-only

law_report

A REPORT of a divergence between the formalisation and the source: the answer contradicts the pinned text, a norm of the source is not expressed by a rule, a §218 label diverges from the text, an address cannot be found. A report is a hypothesis for triage by a formaliser: it does NOT change the law, it never reaches the answers of the other tools, and "not derived" does not become "derived" because of it. An address is required and is checked against the catalogue: package, fragment (a StableId from law_sources) and/or predicate; callId is the X-Law-Call-Id of the answer you disagree with. The entry goes into the server log.

read-only

Argument	Type	Description
callId	string	the X-Law-Call-Id of the answer you disagree with
package*	string	the instrument of the corpus
category*	any	the kind of divergence: norm not expressed / outcome against the text / label against the text / address not found / text against the official one / other
expected*	string	what the source says (with the article)
fragment	string	the StableId of the source fragment
observed*	string	what the system answered

law_revoke_answer

Revoke a published document using its separate secret. The public id alone grants no control; revocation closes the HTML page, the API and the download.

destructive

Argument	Type	Description
publicId*	string
revokeSecret*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "publicId",
    "revokeSecret"
  ],
  "properties": {
    "publicId": {
      "type": "string"
    },
    "revokeSecret": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

law_rules

The rules of formalised law put into words: exactly how a predicate is derived (premises, source articles). Call this BEFORE supplying facts to law_ask — the rules say which facts are needed instead of leaving them to be guessed. For large instruments package=… returns a table of contents; the full text comes from predicate=…. The listing by package is paged: limit (20 by default, 500 at most) and offset; the remainder is named in the text (`showing a–b of N; k more`) and in structuredContent (total, truncated, next — a ready-made continuation call).

read-only

Argument	Type	Description
lang	any	the language the rules are put into (DECISION-0032; the language of the profile by default; the rest are draft packs, with §218 label overlays)
limit	integer	package: how many rules per page (20; the budget may lower it)
offset	integer	package: from which rule (0)
package	string	every rule of the instrument
predicate	string	the rules that derive this predicate

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lang": {
      "enum": [
        "ru",
        "kk",
        "en",
        "ky",
        "uz",
        "ar",
        "la",
        "zh",
        "de",
        "fr",
        "tr",
        "es",
        "fa",
        "ja"
      ],
      "description": "the language the rules are put into (DECISION-0032; the language of the profile by default; the rest are draft packs, with §218 label overlays)"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "package: how many rules per page (20; the budget may lower it)"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "package: from which rule (0)"
    },
    "package": {
      "type": "string",
      "description": "every rule of the instrument"
    },
    "predicate": {
      "type": "string",
      "description": "the rules that derive this predicate"
    }
  },
  "additionalProperties": false
}

law_screen

Build a necessary condition — a superset — for the preliminary selection of rows from an external source (DECISION-0120). This is NOT a legal answer and NOT SQL: the result is a typed tree and a manifest of the extensions up to TRUE. Every row that passes must then be computed in full by the engine, with a proof graph, on the same snapshot of the data. The binding is passed as a pinnable object; sourceSchemaContentHash is the actual hash of the source schema and is compared loudly with the pin. Case facts that carry provenance (origin, document, quote, extractor) are supplied to law_ask, not here. The confidence figure is read by the package EvidencePolicy, not by this tool and not by the engine.

read-only

Argument	Type	Description
goal*	string	a StableId or a unique short name of the goal
binding*	object	a law.screen.binding/0.1 artefact
package*	string	the package key from law_packages
legalTime	string	the date of the law YYYY-MM-DD; without it every window of every rule is taken into account
sourceSchemaContentHash*	string	the actual sha256 of the source schema

Input schema (JSON)

{
  "type": "object",
  "required": [
    "package",
    "goal",
    "binding",
    "sourceSchemaContentHash"
  ],
  "properties": {
    "goal": {
      "type": "string",
      "description": "a StableId or a unique short name of the goal"
    },
    "binding": {
      "type": "object",
      "description": "a law.screen.binding/0.1 artefact"
    },
    "package": {
      "type": "string",
      "description": "the package key from law_packages"
    },
    "legalTime": {
      "type": "string",
      "description": "the date of the law YYYY-MM-DD; without it every window of every rule is taken into account"
    },
    "sourceSchemaContentHash": {
      "type": "string",
      "description": "the actual sha256 of the source schema"
    }
  },
  "additionalProperties": false
}

law_search

A semantic SEARCH over formalised law: a question or a notion in your own words → candidates with addresses — predicates with signatures, rules, article fragments. This is the layer of DISCOVERY, not of the answer: the result says WHAT to ask next (law_ask by signature, law_rules, law_sources) and establishes neither a fact nor a norm. The ranking is a deterministic lexical embedder (DECISION-0040), and similarity of text is not applicability of a norm. If you know the exact name, go straight to law_packages/law_ask; an empty result does NOT mean the norm does not exist.

read-only

Argument	Type	Description
kinds	array	narrow the kinds of candidate
limit	integer	how many candidates (8, at most 25)
query*	string	a question or a notion in your own words
package	string	search inside this instrument only

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "kinds": {
      "type": "array",
      "items": {
        "enum": [
          "package",
          "predicate",
          "rule",
          "norm",
          "constraint",
          "fragment"
        ]
      },
      "description": "narrow the kinds of candidate"
    },
    "limit": {
      "type": "integer",
      "description": "how many candidates (8, at most 25)"
    },
    "query": {
      "type": "string",
      "description": "a question or a notion in your own words"
    },
    "package": {
      "type": "string",
      "description": "search inside this instrument only"
    }
  },
  "additionalProperties": false
}

law_sources

Sources: by default short excerpts (view=summary), 5 texts per page, with the address of the full text in fragments[].full. Either package or fragment is required (a StableId from law_search/law_rules). view=full returns exact parts of the text: textRange sets a range of Unicode characters, fragments[].next is the continuation with a contentHash. The hash refers to the WHOLE source, not to the excerpt or the part. textOffset/textLimit require fragment; a continuation requires contentHash. Lists are paged with offset/limit; the answer budget may shrink a page.

read-only

Argument	Type	Description
view	any
limit	integer	how many texts: summary 5, full 1 (the budget may lower it)
offset	integer	from which fragment (0)
status	string	the status of the variant, as given on the source card
package	string	the package key — every fragment of that instrument
fragment	string	the StableId of a fragment
language	string	the language of the variant, as given on the source card
textLimit

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "args": {
      "type": "array",
      "description": "the arguments of the predicate in the order of its signature; with kind='collect' exactly one of them is the selection variable ?name (for example ['urn:x:water', 'urn:x:mix', '?value']), the rest are values. Values follow the parameter type: an entity — 'urn:…' or a short name; Date — 'YYYY-MM-DD'; Money — '<number> <currency>' ('43250 KZT'); Quantity — '<number> <unit>' with the unit exactly as the package spells it ('25 calendar_year', '30 meter'; law_packages shows the units of the constants, units are never converted — §49); a constant of the package — its name"
    },
    "calc": {
      "description": "kind='calc': a tree {op,left,right}, op ∈ add|sub|mul|div|le|lt|ge|gt|eq|ne (the synonyms divide/multiply/plus/minus and the signs are accepted); the leaves are 5 | '3932 KZT' | '2 mrp' | {lookup: 'mrp', args: [2026]} — a statutory value from the corpus; aggregates §59 are {aggregate: 'sum', element: '?v', over: [{predicate, args with '?variables'}]} over the facts given in facts"
    },
    "days": {
      "type": "integer",
      "description": "deadline: the length of the period"
    },
    "kind": {
      "enum": [
        "truth",
        "collect",
        "deadline",
        "calc",
        "positions",
        "why_not"
      ],
      "description": "the kind of question (truth by default)"
    },
    "unit": {
      "enum": [
        "calendar_day",
        "business_day"
      ]
    },
    "after": {
      "type": "string",
      "description": "deadline: the date of the event"
    },
    "facts": {
      "type": "array",
      "description": "facts of the case: [{predicate, args, negated?, package?, provenance?, judgment?}]. package resolves an ambiguous short name. provenance is {origin?, evidence?: StableId, span?: {page?, quote?, offset?}, extractor?: {name, version?, confidence?}, observedAt?, recordedAt?}. origin defaults to case_input (section 73; extraction adds no origin value): the extractor is lowered to a was_generated_by edge, the document to was_derived_from. confidence is a decimal string; the threshold is read by the package EvidencePolicy (field confidence), not by the engine. A fact with an extractor and no evidence is accepted as case_input and yields the warning FACT_WITHOUT_EVIDENCE. A call without provenance is unchanged. args use the same notation as the args of the question"
    },
    "proof": {
      "type": "boolean",
      "description": "return the evaluation field with the proof graph in the answer — a ready-made input for law_explain (kind truth|collect; by default a summary without the graph)"
    },
    "cutoff": {
      "type": "string",
      "description": "deadline: the hour operations close"
    },
    "focused": {
      "type": "boolean",
      "description": "kind='truth': ask as focused_truth (§181.3) — the same answer as the full truth, but the proof and the warnings cover only the cone of the question; the answer carries evaluationKind and the slice hashes (focus); the cone in focus is reduced to coneHash and the predicate count, the full cone manifest comes in evaluation.focusManifest with proof=true. A slice is not an audit document: law_prepare_answer does not accept it for publication"
    },
    "package": {
      "type": "string",
      "description": "narrow the question to one package of law"
    },
    "version": {
      "type": "string",
      "description": "the exact package version pinned by the client (open('name@version')); if it differs from the profile composition the host refuses instead of answering with another version"
    },
    "evidence": {
      "type": "array",
      "description": "case documents, section 74, evidence_item nodes. One document is referenced from provenance.evidence of many facts. payload.confidence is data for the EvidencePolicy; the engine does not evaluate the number"
    },
    "afterTime": {
      "type": "string",
      "description": "deadline: the time of filing"
    },
    "legalTime": {
      "type": "string",
      "description": "the date of the law (YYYY-MM-DD)"
    },
    "predicate": {
      "type": "string",
      "description": "what is being asked, e.g. 'duty_amount'"
    },
    "responseMode": {
      "enum": [
        "full",
        "compact"
      ],
      "description": "full (default) — the complete answer. compact is accepted for compatibility: this server builds no short reply and returns the same complete answer in both modes; there is no fullAnswer reference and no stored snapshot of the answer."
    },
    "supportEdges": {
      "type": "array",
      "description": "support edges, section 75, support_edge nodes: from is the document id, to is the fact literal, relation is supports or refutes. Admission is decided by the package EvidencePolicy, not by the host"
    },
    "deadlinePolicy": {
      "type": "object",
      "description": "the §86 policy for counting time limits expressed in days: {start_count: 'same_day'|'next_day', include_end: true|false, roll: 'no_roll'|'next_working_day'|'previous_working_day'[, month_end: 'last_day_of_month' — for months and years only]}. Without it a norm carrying a time limit answers with a DEADLINE_POLICY_* warning — the policy is set by the law of procedure and the server never assumes one. The snapshot of the official calendar §85 for working days is supplied by the server itself whenever an instrument counts them."
    },
    "evidencePolicy": {
      "type": "string",
      "description": "StableId of an evidence_policy node, section 78.2. Without it, previous calls keep their behaviour. The confidence threshold is a rule of that policy, not an argument of the call"
    },
    "selectedInterpretations": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "named readings §152; for an exactly_one group choose exactly one StableId out of law_packages/law_rules"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "case": {
      "type": "object",
      "description": "the case for query-over; it replaces the case clause"
    },
    "full": {
      "type": "boolean",
      "description": "das vollständige queryResult statt einer Seite zurückgeben; nur wenn der Bereich ein einzelnes Paket ist"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "an explicit cap on eval() materialisations (it does NOT bound the rows — see rowLimit)"
    },
    "query": {
      "type": "string",
      "description": "inline LawQL"
    },
    "corpus": {
      "type": "string",
      "description": "der Bereich des Schnappschusses: ein package.name (zum Beispiel kz.corpus.labour_code) oder ein Glob über package.name; ohne corpus der gesamte Profilausschnitt"
    },
    "engine": {
      "enum": [
        "lawc"
      ],
      "default": "lawc",
      "description": "there is one engine — the core; the reference implementation is called by its own command"
    },
    "question": {
      "type": "string",
      "description": "der Name einer Frage aus dem Katalog corpus/ql/questions (producers, readers, anchors-of, imports-of, links-of, type-step) oder eines Lints; anstelle von query"
    },
    "rowLimit": {
      "type": "integer",
      "maximum": 5000,
      "minimum": 1,
      "description": "how many rows in structuredContent (20; the budget may lower it)"
    },
    "snapshot": {
      "type": "string",
      "description": "der Schnappschuss-Hash aus next.snapshot der vorherigen Seite: eine Fortsetzung auf einem anderen Schnappschuss wird abgelehnt (SNAPSHOT_CHANGED)"
    },
    "arguments": {
      "type": "object",
      "description": "die Parameter der Frage: ein Objekt „Name → Zeichenkette“ (predicate, node, type — URNs; pkg — ein package.name oder ein Glob)"
    },
    "rowOffset": {
      "type": "integer",
      "minimum": 0,
      "description": "ab welcher Zeile (0); die Fortsetzung kommt aus next zusammen mit snapshot; nur strukturelle Abfragen"
    }
  },
  "additionalProperties": false
}

case	object	the case for query-over; it replaces the case clause
full	boolean	das vollständige queryResult statt einer Seite zurückgeben; nur wenn der Bereich ein einzelnes Paket ist
limit	integer	an explicit cap on eval() materialisations (it does NOT bound the rows — see rowLimit)
query	string	inline LawQL
corpus	string	der Bereich des Schnappschusses: ein package.name (zum Beispiel kz.corpus.labour_code) oder ein Glob über package.name; ohne corpus der gesamte Profilausschnitt
engine	any	there is one engine — the core; the reference implementation is called by its own command
question	string	der Name einer Frage aus dem Katalog corpus/ql/questions (producers, readers, anchors-of, imports-of, links-of, type-step) oder eines Lints; anstelle von query
rowLimit	integer	how many rows in structuredContent (20; the budget may lower it)
snapshot	string	der Schnappschuss-Hash aus next.snapshot der vorherigen Seite: eine Fortsetzung auf einem anderen Schnappschuss wird abgelehnt (SNAPSHOT_CHANGED)
arguments	object	die Parameter der Frage: ein Objekt „Name → Zeichenkette“ (predicate, node, type — URNs; pkg — ein package.name oder ein Glob)
rowOffset	integer	ab welcher Zeile (0); die Fortsetzung kommt aus next zusammen mit snapshot; nur strukturelle Abfragen