How to use the site and the ledger

What each part of the site shows, how to read a comparison, how to check any fact yourself, and how agents and developers can use the API and MCP server.

What is presented, and what is not

ShownNot shown (by design)
Official national procedure and billing codes, with their original labels and two English translationsMedical advice or treatment recommendations
Which codes correspond to a shared reference concept, as proposed or reviewed mappingsClaims that two national procedures are clinically identical
Official prices where a public source exists (NL now; DE and RO planned)Your personal costs, which depend on your insurance and co-payments
EU routes for treatment abroad, with the legal articlesPatient data of any kind; nothing personal is collected or stored
A full, verifiable log of every document readThe original files of sources that may not be redistributed (e.g. the Romanian PDF); their code labels are shown, with citation

1. Compare a procedure

  1. On Compare, choose a concept such as Mastectomy or Nipple-sparing mastectomy. Choosing a parent concept also includes its sub-types.
  2. Each country card lists the national codes mapped to it:
    • Code and the original label as the publisher wrote it, in its own column.
    • English (glossary LLM) and English (MT baseline) in separate columns, so wording differences are visible. "Pending" means the translation waits for the next AI budget reset.
    • The Side by side table puts the countries in columns for each concept, for direct visual comparison.
    • Mapping: proposed (machine, unreviewed) or confirmed (reviewed by a person), plus the relation, e.g. closeMatch ≈ same, broadMatch = the code is more specific than the concept.
    • Src #n: the ledger entry of the document the code came from. Click it for the full trail.
  3. The gap line summarises how far the country is from the reference: 0% = covered with an exact code, 100% = no code at all. Components are explained in How it works §9.
  4. "No national code mapped yet" can mean the country really has no specific code, the source hasn't been ingested yet, or the rules missed it. Sources checked, and why shows the last outcome per source.

2. Read the EU layer

Under the comparison, EU layer shows the EU rule that applies: articles of Directive 2011/24/EU and Regulation 883/2004 in each official language, with a link to EUR-Lex and the ledger entry. It also shows the EU guidance and international standards the concept is defined against, each marked ingested, referenced or planned.

3. Check any fact yourself

  1. Lineage: click a Src #n link, or open /api/lineage?sha256=<hash>. You get every ledger event for that document: the robots.txt decision, fetch_started, fetch_completed (URL, HTTP status, size, SHA-256), extraction, parsing (with a hash of the parsed records), translation and mapping.
  2. Original: for openly licensed sources, /api/artifact/<sha256> returns the exact bytes. Hash them yourself (sha256sum) and compare.
  3. Chain integrity: the Verify button on Compare, or /api/ledger/verify?from=1&limit=500, recomputes every row hash and checks each row points to the one before.
  4. Changes: /api/changes?after=<id> lists what changed (new document versions, codes, mappings, tariffs, gap scores), each tied to a ledger entry.

4. Use the API

EndpointReturns
GET /api/compare?concept=oncology.breast.mastectomyPer country: matches, gap, tariffs; EU layer; entitlement routes
GET /api/codes?q=mastek&jurisdiction=DECode search by code, original label or English label
GET /api/cross-border?from=RO&to=NLS2 and Directive routes with article excerpts
GET /api/sources · /api/standards · /api/glossary · /api/rulesSources with rationale and last outcome; referenced standards; translation glossary; matching rules
GET /api/lineage?sha256=… · /api/ledger?after=0 · /api/ledger/verifyAudit trail, raw ledger, verification
GET /api/model · /api/pipeline · /api/statusLive schema and row counts; job and event statistics; ledger head and free-tier use
GET /api/compactsThe English reference cards of the legal texts
curl "https://rosetta.covlescu.com/api/compare?concept=oncology.breast.mastectomy.nipple_sparing"

5. Use it from an AI assistant (MCP)

The MCP endpoint is POST /mcp (Streamable HTTP, read-only). In Claude: Settings → Connectors → Add custom connector, then paste https://rosetta.covlescu.com/mcp.

ToolAsk it, for example…
compare_procedure"How is a nipple-sparing mastectomy coded in Germany vs Romania?"
cross_border_options"I live in Romania; how can I get breast surgery in the Netherlands reimbursed?"
search_codes"Find Dutch care products for breast-conserving surgery."
whats_changed"What changed in the sources this week?"
audit_trail, ledger_status"Where does code 5-877.2 come from, and is the ledger intact?"
curl -s -X POST https://rosetta.covlescu.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cross_border_options","arguments":{"from_country":"RO","to_country":"NL"}}}'

6. For the operator

Admin endpoints need Authorization: Bearer <ADMIN_TOKEN>:

Adding a country or code system is a database migration with new rows (source, procedure system, keyword rules, glossary terms). No code changes are needed unless the file format is new.