KG-SSOT MCP server

KG-SSOT

Verifiable knowledge graphs in plain text: every claim says where it came from, when it was last verified and what depends on it, and your CI rejects the ones that don't.

English | Português (Brasil)

Manual · Adopt it · The contract · Conformance suite · Changelog · For AI agents

Why

Teams, of people or of agents, pile up conclusions: "the retry is idempotent", "we decided on three attempts". They live in meeting notes, tickets and chat memories, and on the way they lose three things: the source, the date it was last verified and what depends on it. A convincing sentence without any of the three passes a hurried review.

KG-SSOT treats this as a format problem, not a discipline problem. Knowledge lives in a .kg.yaml graph, versioned next to the code, and a formal contract decides in CI what fails:

unverifiable instead);

• a confirmed or production node without provenance fails (a claim with no recoverable source is declared

testimony raise warnings.

• a source that is only a placeholder (unknown, n/a, tbd) fails;
• an edge that points nowhere fails, and so does a node with no edges;
• a verification stamp with nothing to check against, a decision with no origin and a production claim backed only by

Get started in 60 seconds

pip install kg-ssot

# the conformance suite against the reference reader, from the installed package
kg-conformance | tail -2

# one valid graph and one that fails
kg-validate valid.kg.yaml broken.kg.yaml

Or straight from the repository, with hash-checked dependencies:

git clone https://github.com/marciocar/kg-ssot && cd kg-ssot
python3 -m venv .venv && .venv/bin/pip install --require-hashes -r tools/requirements.txt
.venv/bin/python3 -I tools/kg_validate.py \
  spec/conformance/fixtures/latest/form/minimal/valid-minimal.kg.yaml \
  spec/conformance/fixtures/latest/form/minimal/bad-node-missing-label.kg.yaml

PASS spec/conformance/fixtures/latest/form/minimal/valid-minimal.kg.yaml
FAIL spec/conformance/fixtures/latest/form/minimal/bad-node-missing-label.kg.yaml
  MUST   form.required.node.label ×1
· 2 files; 1 pass the MUST; 0 with a SHOULD warning (kg-contract-v4.schema.json + kg-contract-v4.should.schema.json)

The tools print in English by default and in Brazilian Portuguese when your locale is ptBR (or KGSSOT_LANG=pt-BR). Codes, exit codes and JSON keys never change with the language; only the human text does.

Install

Shortened. The full README is on GitHub.