argus-aml 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daertho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,15 +1,69 @@
 # argus-aml
 
-Add the Argus API's compliance tools to your AI agent.
+Add the [Argus API](https://daertho.com/founders/)'s compliance tools to your AI agent: sanctions and PEP screening,
+adverse media, face checks, e-signatures and financial-crime typologies, as MCP tools.
 
 ```bash
 npx argus-aml init
 ```
 
-This creates a sandbox key, then adds Argus to Claude Code and Cursor if it finds them. Sandbox results are invented and
-cost nothing.
+It starts you on a sandbox key. Sandbox results are invented, cost nothing, and need no account.
 
-Use your live key with `npx argus-aml init --key ak_...`.
+## What this script does
 
-Your key is saved to `~/.config/argus/key`, readable only by you. For any other MCP client, point it at
-`https://argus.unbackoffice.com/mcp` and send your key in the `X-API-Key` header.
+Exactly this, and nothing else:
+
+1. **One request** to `POST https://argus.unbackoffice.com/v1/founder/sandbox-key` to create a sandbox key.
+   No account, no email, no personal data. Skipped when you pass `--key` or a key is already saved.
+2. **Writes one file**, `~/.config/argus/key`, with mode 600 so only you can read it.
+3. **Adds the Argus server** to the agents it finds on this machine, and only those:
+
+   | Agent      | How it's detected          | What is touched                                     |
+   | ---------- | -------------------------- | --------------------------------------------------- |
+   | Claude Code | `claude` CLI on your PATH | `claude mcp add --scope user argus …`               |
+   | Cursor     | `~/.cursor/` exists        | `argus` entry in `~/.cursor/mcp.json`               |
+   | Codex      | `~/.codex/` exists         | `[mcp_servers.argus]` in `~/.codex/config.toml`     |
+   | Windsurf   | `~/.codeium/windsurf/`     | `argus` entry in `~/.codeium/windsurf/mcp_config.json` |
+   | Gemini CLI | `~/.gemini/` exists        | `argus` entry in `~/.gemini/settings.json`          |
+
+   Only the `argus` entry is written; the rest of each file is left as it was. A config file that isn't valid JSON is
+   left alone and reported.
+
+It sends nothing else anywhere and collects no telemetry. The whole script is [`bin/init.js`](bin/init.js), about
+200 lines with no dependencies. To see what it would do on your machine before it does it:
+
+```bash
+npx argus-aml init --print
+```
+
+## Going live
+
+When Daertho issues your live key, run the same command with it:
+
+```bash
+npx argus-aml init --key ak_your_live_key
+```
+
+Same URL, same tools. The only change is that results stop carrying `"sandbox": true`. Running `init` again later
+keeps the saved key: it never swaps a live key for a sandbox one.
+
+## Any other MCP client
+
+Point it at `https://argus.unbackoffice.com/mcp` and send your key in the `X-API-Key` header. The Claude desktop app
+adds remote servers through its own Connectors settings rather than a config file, so this script can't set it up;
+use the URL there.
+
+## Plain HTTP
+
+```bash
+curl https://argus.unbackoffice.com/v1/screen \
+  -H "X-API-Key: $(cat ~/.config/argus/key)" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Sandbox Sanctioned"}'
+```
+
+API reference: https://argus.unbackoffice.com/developers/reference
+
+## Licence
+
+The installer in this package is MIT licensed. The Argus API it connects to is a Daertho service under its own terms.

package/bin/init.js

@@ -1,6 +1,17 @@
 #!/usr/bin/env node
 "use strict";
 // npx argus-aml init: get a sandbox key (or take --key) and add the Argus MCP server to the agents on this machine.
+//
+// Everything this script does, and nothing else:
+//   1. POST https://argus.unbackoffice.com/v1/founder/sandbox-key, only when no key is given or already saved
+//   2. write ~/.config/argus/key, readable only by you
+//   3. add the Argus server to the agents it finds on this machine:
+//        Claude Code   `claude mcp add` (needs the Claude Code CLI on PATH)
+//        Cursor        ~/.cursor/mcp.json
+//        Codex         ~/.codex/config.toml
+//        Windsurf      ~/.codeium/windsurf/mcp_config.json
+//        Gemini CLI    ~/.gemini/settings.json
+// It sends nothing else anywhere and collects no telemetry. `--print` shows these steps without doing them.
 const fs = require("fs");
 const os = require("os");
 const path = require("path");
@@ -8,8 +19,11 @@ const { spawnSync } = require("child_process");
 
 const API = (process.env.ARGUS_API_URL || "https://argus.unbackoffice.com").replace(/\/$/, "");
 const MCP = API + "/mcp";
+const HOME = os.homedir();
+const KEY_FILE = path.join(HOME, ".config", "argus", "key");
 const ok = (s) => console.log("✓ " + s);
 const fail = (s) => { console.error("✗ " + s); process.exit(1); };
+const mask = (key) => (key ? key.slice(0, 6) + "…" : "");
 
 function argValue(args, name) {
   const i = args.indexOf(name);
@@ -32,41 +46,25 @@ async function sandboxKey() {
 
 function savedKey() {
   try {
-    return fs.readFileSync(path.join(os.homedir(), ".config", "argus", "key"), "utf8").trim();
+    return fs.readFileSync(KEY_FILE, "utf8").trim();
   } catch (e) {
     return "";
   }
 }
 
 function saveKey(key) {
-  const dir = path.join(os.homedir(), ".config", "argus");
-  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
-  const file = path.join(dir, "key");
-  fs.writeFileSync(file, key + "\n", { mode: 0o600 });
-  fs.chmodSync(file, 0o600);
-  return file;
+  fs.mkdirSync(path.dirname(KEY_FILE), { recursive: true, mode: 0o700 });
+  fs.writeFileSync(KEY_FILE, key + "\n", { mode: 0o600 });
+  fs.chmodSync(KEY_FILE, 0o600);
+  return KEY_FILE;
 }
 
 function onPath(cmd) {
   return spawnSync(process.platform === "win32" ? "where" : "which", [cmd], { stdio: "ignore" }).status === 0;
 }
 
-function addToClaude(key) {
-  if (!onPath("claude")) return false;
-  spawnSync("claude", ["mcp", "remove", "argus", "--scope", "user"], { stdio: "ignore" });
-  const r = spawnSync("claude", ["mcp", "add", "--transport", "http", "--scope", "user", "argus", MCP,
-    "--header", "X-API-Key: " + key], { encoding: "utf8" });
-  if (r.status !== 0) {
-    console.error("✗ Couldn't add Argus to Claude Code: " + ((r.stderr || "").replace(key, "***").trim() || "unknown error"));
-    return false;
-  }
-  return true;
-}
-
-function addToCursor(key) {
-  const dir = path.join(os.homedir(), ".cursor");
-  if (!fs.existsSync(dir)) return false;
-  const file = path.join(dir, "mcp.json");
+// Replace or add the "argus" entry under mcpServers in a JSON config file. A file that isn't valid JSON is left alone.
+function writeJsonEntry(file, entry) {
   let cfg = {};
   if (fs.existsSync(file)) {
     try {
@@ -76,39 +74,127 @@ function addToCursor(key) {
       return false;
     }
   }
-  cfg.mcpServers = { ...(cfg.mcpServers || {}), argus: { url: MCP, headers: { "X-API-Key": key } } };
+  cfg.mcpServers = { ...(cfg.mcpServers || {}), argus: entry };
+  fs.mkdirSync(path.dirname(file), { recursive: true });
   fs.writeFileSync(file, JSON.stringify(cfg, null, 2) + "\n", { mode: 0o600 });
   fs.chmodSync(file, 0o600);
   return true;
 }
 
+// Replace or add the [mcp_servers.argus] table in a TOML file, without touching anything else in it.
+function writeTomlTable(file, lines) {
+  let text = fs.existsSync(file) ? fs.readFileSync(file, "utf8") : "";
+  const block = "[mcp_servers.argus]\n" + lines.join("\n") + "\n";
+  const re = /^\[mcp_servers\.argus\]\n(?:(?!\[)[^\n]*\n?)*/m;
+  if (re.test(text)) text = text.replace(re, (m, at) => block + (at + m.length < text.length ? "\n" : ""));
+  else text = text.replace(/\s*$/, "") + (text.trim() ? "\n\n" : "") + block;
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, text, { mode: 0o600 });
+  fs.chmodSync(file, 0o600);
+  return true;
+}
+
+// Each agent: how it's detected, what gets touched, and how to add the server.
+const AGENTS = [
+  {
+    name: "Claude Code",
+    found: () => onPath("claude"),
+    touches: "`claude mcp add --scope user argus` (your Claude Code user config)",
+    add(key) {
+      spawnSync("claude", ["mcp", "remove", "argus", "--scope", "user"], { stdio: "ignore" });
+      const r = spawnSync("claude", ["mcp", "add", "--transport", "http", "--scope", "user", "argus", MCP,
+        "--header", "X-API-Key: " + key], { encoding: "utf8" });
+      if (r.status !== 0) {
+        console.error("✗ Couldn't add Argus to Claude Code: " + ((r.stderr || "").split(key).join("***").trim() || "unknown error"));
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "Cursor",
+    file: path.join(HOME, ".cursor", "mcp.json"),
+    found() { return fs.existsSync(path.dirname(this.file)); },
+    add(key) { return writeJsonEntry(this.file, { url: MCP, headers: { "X-API-Key": key } }); },
+  },
+  {
+    name: "Codex",
+    file: path.join(HOME, ".codex", "config.toml"),
+    found() { return fs.existsSync(path.dirname(this.file)); },
+    add(key) {
+      return writeTomlTable(this.file, ['url = "' + MCP + '"', 'http_headers = { "X-API-Key" = "' + key + '" }']);
+    },
+  },
+  {
+    name: "Windsurf",
+    file: path.join(HOME, ".codeium", "windsurf", "mcp_config.json"),
+    found() { return fs.existsSync(path.dirname(this.file)); },
+    add(key) { return writeJsonEntry(this.file, { serverUrl: MCP, headers: { "X-API-Key": key } }); },
+  },
+  {
+    name: "Gemini CLI",
+    file: path.join(HOME, ".gemini", "settings.json"),
+    found() { return fs.existsSync(path.dirname(this.file)); },
+    add(key) { return writeJsonEntry(this.file, { httpUrl: MCP, headers: { "X-API-Key": key } }); },
+  },
+];
+
+function manualInstructions(file) {
+  console.log("\nAdd this to any MCP client:");
+  console.log("  URL:    " + MCP);
+  console.log("  Header: X-API-Key: " + (file ? "(the key in " + file + ")" : "your key"));
+}
+
+function printPlan(given) {
+  console.log("argus-aml init would do this, and nothing else:\n");
+  if (given) console.log("  1. Use the key you gave (" + mask(given) + "); no request is made to create one");
+  else console.log("  1. POST " + API + "/v1/founder/sandbox-key to create a sandbox key (no account, no personal data)");
+  console.log("  2. Write " + KEY_FILE + " (mode 600: readable only by you)");
+  console.log("  3. Add the server " + MCP + " with header X-API-Key to the agents found on this machine:");
+  let any = false;
+  for (const a of AGENTS) {
+    const here = a.found();
+    any = any || here;
+    console.log("       " + (here ? "found    " : "not found") + "  " + a.name + "  →  " + (a.touches || a.file));
+  }
+  if (!any) console.log("       (none found: it would print the URL and header for you to add by hand)");
+  console.log("\nNothing else is sent or stored. Run without --print to do it.");
+}
+
 async function main() {
   const args = process.argv.slice(2);
   if (args[0] !== "init") {
-    console.log("Usage: npx argus-aml init [--key ak_...]");
+    console.log("Usage: npx argus-aml init [--key ak_...] [--print]");
+    console.log("  --key    use a key you already have (your live key, after Daertho issues one)");
+    console.log("  --print  show what init would do on this machine without doing it");
     process.exit(args.length && !["-h", "--help"].includes(args[0]) ? 1 : 0);
   }
   // a key saved by an earlier run is kept: running init again must never swap a live key for a sandbox one
   const given = argValue(args, "--key") || process.env.ARGUS_API_KEY || savedKey();
+  if (args.includes("--print")) return printPlan(given);
+
   const key = given || (await sandboxKey());
-  ok(given ? "Using your API key" : "Sandbox key created");
+  ok(given ? "Using your API key (" + mask(key) + ")" : "Sandbox key created");
   const file = saveKey(key);
   ok("Key saved to " + file);
 
   const added = [];
-  if (addToClaude(key)) added.push("Claude Code");
-  if (addToCursor(key)) added.push("Cursor");
+  for (const a of AGENTS) if (a.found() && a.add(key)) added.push(a.name);
   if (added.length) {
-    ok("Argus tools added to " + added.join(" and "));
+    ok("Argus tools added to " + added.join(", "));
+    manualInstructions(file);
+    console.log("\nRestart your agent, then try:");
   } else {
-    console.log("\nNo supported agent found. Add this to any MCP client:");
-    console.log("  URL:    " + MCP);
-    console.log("  Header: X-API-Key: (the key in " + file + ")");
+    console.log("\nNo supported agent found on this machine.");
+    if (!onPath("claude")) {
+      console.log("  The Claude Code CLI isn't on your PATH (the Claude desktop app alone can't be set up by this script).");
+      console.log("  Install it with: npm install -g @anthropic-ai/claude-code   then run this again.");
+    }
+    manualInstructions(file);
+    console.log("\nThen try:");
   }
-  if (added.length) console.log("\nRestart your agent, then try:");
-  else console.log("\nThen try:");
   console.log("  Screen Sandbox Sanctioned and tell me what happens next.");
   if (!given) console.log("\nSandbox results are invented. Ask for a live key at " + API + "/developers");
 }
 
-main().catch(() => fail("Something went wrong. Try again."));
+main().catch((e) => fail("Something went wrong: " + (e && e.message ? e.message : e)));

package/package.json

@@ -1,9 +1,15 @@
 {
   "name": "argus-aml",
-  "version": "0.1.0",
-  "description": "Add the Argus API's compliance tools to your AI agent.",
+  "version": "0.1.1",
+  "description": "Add the Argus API's compliance tools (sanctions and PEP screening, adverse media, face checks, e-signatures, typologies) to your AI agent.",
+  "keywords": ["aml", "sanctions", "pep", "kyc", "compliance", "mcp", "claude-code", "cursor", "codex", "argus", "daertho"],
+  "homepage": "https://daertho.com/founders/",
+  "repository": { "type": "git", "url": "git+https://github.com/sect0rial/argus-aml.git" },
+  "bugs": { "url": "https://github.com/sect0rial/argus-aml/issues", "email": "1@daertho.com" },
+  "author": "Daertho <1@daertho.com> (https://daertho.com)",
+  "license": "MIT",
   "bin": { "argus-aml": "bin/init.js" },
-  "files": ["bin", "README.md"],
+  "files": ["bin", "README.md", "LICENSE"],
   "engines": { "node": ">=18" },
-  "license": "UNLICENSED"
+  "publishConfig": { "access": "public", "provenance": true }
 }