@stratta/mcp 1.21.0 → 1.22.0

package/README.md

@@ -49,8 +49,8 @@ This package is what you want when:
 
 ## Lighter setup: `--simple`
 
-By default the server announces all 59 tools (about 67,000 characters of
-schemas). `--simple` announces only the 10 norm-reading tools (about 11,000),
+By default the server announces all 60 tools (about 67,000 characters of
+schemas). `--simple` announces only the 11 norm-reading tools (about 11,000),
 which is enough for an agent that just reads norms:
 
 ```bash
@@ -193,23 +193,24 @@ named `E2E dossier <timestamp>` and does not delete it.
 ## Tools exposed
 
 62 tools, generated from one catalogue shared with the remote connector. This
-package announces 59 of them; the remote connector serves 61: everything minus
-`add_attachment`, plus the three tools a host calls for the person, listed last.
+package announces 60 of them; the remote connector serves 61: everything minus
+`add_attachment`, plus the two tools a host calls for the person, listed last.
 
 **Read** (10 tools — query the norms of your workspace):
 
-| Tool              | Purpose                                                                                          |
-| ----------------- | ------------------------------------------------------------------------------------------------ |
-| `get_methodology` | Behavioural contract: persona, workflow, meta-routing hints, answer rules. Call first.           |
-| `whoami`          | Which organisation, role and plan this connection reads as, and how many norms it sees.          |
-| `list_norms`      | List the norms of your workspace, filtered by `query` (code or title words), bounded by `limit`. |
-| `get_toc`         | Hierarchical TOC for a norm (default `maxDepth=1` = chapters).                                   |
-| `get_subtree`     | Drill into a chapter/section subtree (`path` + `maxDepth`).                                      |
-| `get_section`     | Full enriched content of a section (formulas, tables, figures, cross-refs).                      |
-| `search_in_norm`  | Keyword search inside a norm.                                                                    |
-| `search_corpus`   | Keyword search across every norm of the workspace, grouped by norm.                              |
-| `get_figure`      | Retrieve a figure inline (base64 ImageContent).                                                  |
-| `get_cross_refs`  | Outgoing cross-refs from a section to other norms.                                               |
+| Tool              | Purpose                                                                                                             |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `get_methodology` | Behavioural contract: persona, workflow, meta-routing hints, answer rules. Call first.                              |
+| `whoami`          | Which organisation, role and plan this connection reads as, and how many norms it sees.                             |
+| `list_norms`      | List the norms of your workspace, filtered by `query` (code or title words), bounded by `limit`.                    |
+| `get_toc`         | Hierarchical TOC for a norm (default `maxDepth=1` = chapters).                                                      |
+| `get_subtree`     | Drill into a chapter/section subtree (`path` + `maxDepth`).                                                         |
+| `get_section`     | Full enriched content of a section (formulas, tables, figures, cross-refs).                                         |
+| `search_in_norm`  | Keyword search inside a norm.                                                                                       |
+| `search_corpus`   | Keyword search across every norm of the workspace, grouped by norm.                                                 |
+| `get_figure`      | Retrieve a figure inline (base64 ImageContent).                                                                     |
+| `get_cross_refs`  | Outgoing cross-refs from a section to other norms.                                                                  |
+| `verify_citation` | Check that a sentence is printed word for word in a clause before quoting it; returns the passage and the citation. |
 
 **Site** (10 tools — what public Swiss registers know about a plot, and the site sheet as the app shows it):
 
@@ -293,13 +294,12 @@ too, and its file is the layout the Word export is rendered into.
 | `ingest_publish`              | Score the document and flip it to published; refuses below 30/100 unless forced. |
 | `ingest_delete`               | Delete a document and all its children.                                          |
 
-**Remote only** (3 tools, served by `https://stratta.ch/mcp` and not by this package, which draws no interface):
+**Remote only** (2 tools, served by `https://stratta.ch/mcp` and not by this package, which draws no interface):
 
-| Tool               | Purpose                                                                                                      |
-| ------------------ | ------------------------------------------------------------------------------------------------------------ |
-| `show_citations`   | Show the clauses an answer cites as cards (an MCP App), each quote checked word for word against the clause. |
-| `open_norm_reader` | The norm reader, opened by the person from the host's side panel or sidebar; hidden from the model.          |
-| `get_profile`      | An opaque id and the organization of the connection, so a host tells two connected accounts apart.           |
+| Tool             | Purpose                                                                                                      |
+| ---------------- | ------------------------------------------------------------------------------------------------------------ |
+| `show_citations` | Show the clauses an answer cites as cards (an MCP App), each quote checked word for word against the clause. |
+| `get_profile`    | An opaque id and the organization of the connection, so a host tells two connected accounts apart.           |
 
 ## How agents should use it
 

package/dist/tools/catalog.gen.js

@@ -178,9 +178,9 @@ export const CATALOG = [
         }
     },
     {
-        "name": "get_figure",
-        "title": "Figure",
-        "description": "Return one figure of a norm as an image: diagrams, charts, standard cross-sections. Call it when the figure carries the rule and describing it in words would lose the content. The figure identifier comes from the figures array of get_section.",
+        "name": "verify_citation",
+        "title": "Verify a quote",
+        "description": "Use this before quoting a clause word for word: checks that the sentence is printed in the clause, whatever its case, accents and line breaks. Returns verified, the passage as the norm prints it and the citation to write after it. When the sentence is not in the clause, verified is false and passage is the closest sentence of the clause, to quote from instead; a changed number makes a quote fail.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -194,13 +194,14 @@ export const CATALOG = [
         "params": {
             "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"EN 1997-1\", \"CO\", \"IFRS 15\".",
             "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
-            "figureId": "Figure identifier from the figures array of get_section."
+            "path": "Section path as it appears in the table of contents, e.g. \"4.2.1\" or \"Annexe A\".",
+            "quote": "The sentence as it will be quoted, at least 8 characters and one sentence or two at most."
         }
     },
     {
-        "name": "show_citations",
-        "title": "Show cited clauses",
-        "description": "Use this when an answer rests on clauses read with get_section and the person should be able to check them: shows those clauses as cards they can open against the norm, once per answer, in the order they were cited. It reads nothing new and does not replace get_section; only clauses actually read belong in it.",
+        "name": "get_figure",
+        "title": "Figure",
+        "description": "Return one figure of a norm as an image: diagrams, charts, standard cross-sections. Call it when the figure carries the rule and describing it in words would lose the content. The figure identifier comes from the figures array of get_section.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -208,16 +209,19 @@ export const CATALOG = [
             "openWorldHint": false
         },
         "transports": [
+            "stdio",
             "remote"
         ],
         "params": {
-            "citations": "The cited clauses, one to eight: code and path as get_section took them, the edition when the norm has several, and optionally the exact sentence quoted from the clause."
+            "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"EN 1997-1\", \"CO\", \"IFRS 15\".",
+            "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
+            "figureId": "Figure identifier from the figures array of get_section."
         }
     },
     {
-        "name": "open_norm_reader",
-        "title": "Norm reader",
-        "description": "Open the norm reader: the norms of the signed-in organization, each with its table of contents and its clauses, browsed by the person. Opened by the person from the side panel or the sidebar, never by the model.",
+        "name": "show_citations",
+        "title": "Show cited clauses",
+        "description": "Use this when an answer rests on clauses read with get_section and the person should be able to check them: shows those clauses as cards they can open against the norm, once per answer, in the order they were cited. It reads nothing new and does not replace get_section; only clauses actually read belong in it.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -227,7 +231,9 @@ export const CATALOG = [
         "transports": [
             "remote"
         ],
-        "params": {}
+        "params": {
+            "citations": "The cited clauses, one to eight: code and path as get_section took them, the edition when the norm has several, and optionally the exact sentence quoted from the clause."
+        }
     },
     {
         "name": "get_profile",

package/dist/tools/read.d.ts

@@ -44,6 +44,12 @@ export declare const getFigure: import("./define.js").ToolDef<{
     edition: z.ZodOptional<z.ZodString>;
     figureId: z.ZodString;
 }>;
+export declare const verifyCitation: import("./define.js").ToolDef<{
+    code: z.ZodString;
+    edition: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    quote: z.ZodString;
+}>;
 export declare const readTools: (import("./define.js").ToolDef<{}> | import("./define.js").ToolDef<{
     query: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
@@ -79,4 +85,9 @@ export declare const readTools: (import("./define.js").ToolDef<{}> | import("./d
     code: z.ZodString;
     edition: z.ZodOptional<z.ZodString>;
     figureId: z.ZodString;
+}> | import("./define.js").ToolDef<{
+    code: z.ZodString;
+    edition: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    quote: z.ZodString;
 }>)[];

package/dist/tools/read.js

@@ -327,6 +327,22 @@ export const getFigure = defineTool({
         };
     },
 });
+export const verifyCitation = defineTool({
+    ...headOf('verify_citation'),
+    inputSchema: {
+        code: code('verify_citation'),
+        edition: edition('verify_citation'),
+        path: path('verify_citation'),
+        quote: z.string().min(8).describe(param('verify_citation', 'quote')),
+    },
+    run: (client, args) => client.action(api._mcp.verifyCitation, {
+        apiKey: requireApiKey(),
+        code: args.code,
+        edition: args.edition,
+        path: args.path,
+        quote: args.quote,
+    }),
+});
 export const readTools = [
     getMethodology,
     whoami,
@@ -337,5 +353,6 @@ export const readTools = [
     searchInNorm,
     searchCorpus,
     getCrossRefs,
+    verifyCitation,
     getFigure,
 ];

package/dist/tools/toolsets.gen.js

@@ -22,10 +22,10 @@ export const TOOLSET_OF = {
     search_in_norm: 'norms',
     search_corpus: 'norms',
     get_cross_refs: 'norms',
+    verify_citation: 'norms',
     get_figure: 'norms',
     // Shown to the person rather than read by the model (ADR 59): remote only.
     show_citations: 'norms',
-    open_norm_reader: 'norms',
     get_profile: 'norms',
     list_dossiers: 'dossiers',
     open_dossier: 'dossiers',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stratta/mcp",
   "mcpName": "ch.stratta/mcp",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "MCP server exposing your organization’s norms and reference documents (standards, laws, regulations) to any MCP client, with exact citations, via Stratta TreeRAG.",
   "license": "UNLICENSED",
   "author": "SmartFlow <hello@stratta.ch>",

package/skills/consult-stratta/SKILL.md

@@ -27,6 +27,7 @@ When the question names a norm absent from the corpus but a norm you hold refers
 ## Answer contract
 
 - Every technical statement rests on a section you read in this conversation and cites it as `[CODE § path, p. N]`, for example `[SIA 267 § 9.5.2.1, p. 63]`. A value with no clause is not an answer.
+- A sentence quoted word for word is checked with `verify_citation` before it is written; when it is refused, quote the passage it returns.
 - A calculation shows its inputs, each with its citation, its formula in LaTeX (`$$...$$`) with every symbol defined and its unit (kN, MPa, CHF, %).
 - Before answering, check: each value has its clause; each clause was read, not remembered from a summary; the resolvable references were followed; what the corpus does not cover is named, with the norm or clause where it is likely to be found.
 - When several norms are cited, group by norm under headings: principle, then method, then conditions of use.