@adrien1212balitrand/auros-mcp 1.4.11 → 1.4.12

package/README.md

@@ -12,18 +12,19 @@ Thin wrapper over `https://getauros.com/api/v1/*` — no local scoring logic.
 
 ## Tools
 
-Default MCP — **six** tools, not a 40-tool dump. Compare ≠ buy. Empty search ≠ does-not-exist.
+Default MCP — **six** intelligence tools plus a **live Score trial**. Not a 40-tool dump. Compare ≠ buy. Empty search ≠ does-not-exist. HTML 404 on intelligence = mapped-not-on-host, not a missing entity.
 
-| Tool | API |
-|------|-----|
-| `auros.resolve` | `/api/v1/intelligence/resolve` |
-| `auros.search` | `/api/v1/intelligence/search` |
-| `auros.research` | `/api/v1/intelligence/research` |
-| `auros.compare` | `/api/v1/intelligence/compare` |
-| `auros.monitor` | `/api/v1/intelligence/monitor` |
-| `auros.evidence` | `/api/v1/intelligence/evidence` |
+| Tool | API | Host |
+|------|-----|------|
+| `score` | `POST /api/v1/score` | **Live** on getauros.com (demo key) |
+| `auros.resolve` | `/api/v1/intelligence/resolve` | Mapped until the host serves intelligence |
+| `auros.search` | `/api/v1/intelligence/search` | Mapped until the host serves intelligence |
+| `auros.research` | `/api/v1/intelligence/research` | Mapped until the host serves intelligence |
+| `auros.compare` | `/api/v1/intelligence/compare` | Mapped until the host serves intelligence |
+| `auros.monitor` | `/api/v1/intelligence/monitor` | Mapped until the host serves intelligence |
+| `auros.evidence` | `/api/v1/intelligence/evidence` | Mapped until the host serves intelligence |
 
-Desk briefs, Score, Green, and per-station memory stay in the package as an **extended** catalog. They register only when `AUROS_MCP_EXTENDED=1`. Causal (`memory_causal`) is extended-only: candidate ≠ cause, could ≠ will, not scientific causality before the data. World snapshots (`memory_world`) and the knowledge frontier (`memory_frontier`) are extended-only: snapshot ≠ complete, empty delta ≠ quiet, frontier ≠ score. Information economy (`memory_economy`) and active acquisition (`memory_acquire`) are extended-only: worth ≠ spent, ranking ≠ scrape, autonomy not live. Agent demand (`memory_demand`) and dependency (`memory_dependency`) are extended-only: repeat ≠ valuable, example 17/40min ≠ SLA. Autonomous agent (`memory_agent`) and orchestrator (`memory_orchestrator`) are extended-only: invents nothing, orchestrator stays AUROS. Specialists (`memory_specialists`) and controlled improvement (`memory_improve`) are extended-only: no monolith, 8% ≠ measured, never self-mutate. Continuous gate (`memory_gate`) and data moat (`memory_moat`) are extended-only: permanent ≠ live CI, 100k shallow pages are not a moat. The grand final (`memory_final`) is extended-only: engines run on the tape (TAPE|UNKNOWN|OPTIONAL_SKIP), tape_live ≠ fetch_live, the loop is the product, mapped ≠ complete. Cursor lots (`memory_lots`) are extended-only: twelve work-order lots, audit first, strengthen don’t rewrite.
+Desk briefs, Green, Watts, ChargeFlow, and per-station memory stay **extended** (`AUROS_MCP_EXTENDED=1`). First prompt that works on production today: score a Luxembourg SPV.
 
 ## Install
 
@@ -44,7 +45,7 @@ node dist/index.js
 |----------|---------|-------------|
 | `AUROS_API_KEY` | `auros_pk_test_demo` | Shared demo key (50 req/mo). Minted free keys: 1000 req/mo via [developers](https://getauros.com/developers). |
 | `AUROS_BASE_URL` | `https://getauros.com` | API base URL |
-| `AUROS_MCP_EXTENDED` | unset | Set `1` to also register the extended catalog (score, desk briefs, per-station memory) |
+| `AUROS_MCP_EXTENDED` | unset | Set `1` to also register desk briefs, Green, Watts, ChargeFlow, per-station memory |
 
 Get your own key:
 
@@ -110,11 +111,9 @@ Restart Cursor or Claude Desktop after saving.
 
 ## Example agent prompts
 
-- *"Score this Luxembourg real-estate SPV for MiCA readiness: retail warehouse €2.5M, professional investors, whitepaper draft."*
-- *"Compare maple-usdc, realt-portfolio, and backed-bib01 side by side."*
-- *"What jurisdictions rank best for tokenized bonds with a 6-month timeline?"*
-- *"Desk brief for powerledger — Promise Gap vs Activity vs Variance, unfused."*
-- *"Activity Index brief for toucan-bct on Polygon — cite the edition UTC."*
+- *"Score this Luxembourg real-estate SPV for MiCA readiness: retail warehouse €2.5M, professional investors, whitepaper draft."* (works on getauros.com today)
+- *"Search Powerledger — empty hits do not mean the name does not exist."* (needs a host that serves `/api/v1/intelligence/*`)
+- Extended-only: desk brief / Watts / ChargeFlow require `AUROS_MCP_EXTENDED=1`.
 
 ## Publishing (maintainers)
 

package/dist/index.js

@@ -4,6 +4,31 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
+// src/host-status.ts
+function isIntelligenceOrMemoryPath(path) {
+  return path.startsWith("/api/v1/intelligence") || path.startsWith("/api/v1/memory");
+}
+function interpretMcpHttpFailure(opts) {
+  const { status, method, path, baseUrl, bodyText, contentType } = opts;
+  const looksHtml = (contentType ?? "").includes("text/html") || /^\s*</.test(bodyText) || bodyText.includes("This page isn\u2019t on the map") || bodyText.includes("This page isn't on the map");
+  if (isIntelligenceOrMemoryPath(path) && (status === 404 || looksHtml)) {
+    return [
+      `MAPPED_NOT_ON_HOST [${status}] ${method} ${path} on ${baseUrl}.`,
+      "Intelligence MCP (auros.search / resolve / research / compare / monitor / evidence) is on this codebase, not claimed live on every host.",
+      "First working trial on getauros.com today: tool `score` (POST /api/v1/score) with the demo key.",
+      "Empty search \u2260 entity does not exist. HTML 404 \u2260 UNKNOWN tape. Set AUROS_BASE_URL to a host that serves /api/v1/intelligence/*."
+    ].join(" ");
+  }
+  try {
+    const json = JSON.parse(bodyText);
+    const err = json?.error;
+    return `[${err?.code ?? status}] ${err?.message ?? "request failed"} (${method} ${path})`;
+  } catch {
+    const snippet = bodyText.replace(/\s+/g, " ").slice(0, 120);
+    return `[${status}] non-JSON response (${method} ${path}): ${snippet}`;
+  }
+}
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://getauros.com";
 var DEFAULT_DEMO_KEY = "auros_pk_test_demo";
@@ -1629,14 +1654,384 @@ var AurosApiClient = class {
       headers,
       body: body !== void 0 ? JSON.stringify(body) : void 0
     });
-    const json = await res.json();
+    const bodyText = await res.text();
     if (!res.ok) {
-      const err = typeof json === "object" && json !== null && "error" in json ? json.error : void 0;
       throw new Error(
-        `[${err?.code ?? res.status}] ${err?.message ?? res.statusText} (${method} ${path})`
+        interpretMcpHttpFailure({
+          status: res.status,
+          method,
+          path,
+          baseUrl: this.baseUrl,
+          bodyText,
+          contentType: res.headers.get("content-type") ?? void 0
+        })
       );
     }
-    return json;
+    try {
+      return JSON.parse(bodyText);
+    } catch {
+      throw new Error(
+        interpretMcpHttpFailure({
+          status: res.status,
+          method,
+          path,
+          baseUrl: this.baseUrl,
+          bodyText,
+          contentType: res.headers.get("content-type") ?? void 0
+        })
+      );
+    }
+  }
+  async verdict(body) {
+    return this.request("POST", "/api/v1/verdict", body);
+  }
+  async greenSignal(body) {
+    return this.request("POST", "/api/v1/green-signal", body);
+  }
+  async greenTransparency(body) {
+    return this.request("POST", "/api/v1/green-transparency", body);
+  }
+  async greenTransparencyCard(id) {
+    return this.request(
+      "GET",
+      "/api/v1/green-transparency/card",
+      void 0,
+      { id },
+      false
+    );
+  }
+  async activityIntegrity(body) {
+    return this.request("POST", "/api/v1/activity-integrity", body);
+  }
+  async activityIntegrityCard(slug) {
+    return this.request(
+      "GET",
+      "/api/v1/activity-integrity/card",
+      void 0,
+      { slug },
+      false
+    );
+  }
+  async variancePhysical(body = {}) {
+    return this.request("POST", "/api/v1/variance-physical", body);
+  }
+  async variancePhysicalCard(token) {
+    return this.request(
+      "GET",
+      "/api/v1/variance-physical/card",
+      void 0,
+      token ? { token } : void 0,
+      false
+    );
+  }
+  async freshnessDecay(body) {
+    return this.request("POST", "/api/v1/freshness-decay", body);
+  }
+  async freshnessDecayCard(id) {
+    return this.request(
+      "GET",
+      "/api/v1/freshness-decay/card",
+      void 0,
+      { id },
+      false
+    );
+  }
+  async frictionSettlement(body) {
+    return this.request("POST", "/api/v1/friction-settlement", body);
+  }
+  async frictionSettlementCard(id) {
+    return this.request(
+      "GET",
+      "/api/v1/friction-settlement/card",
+      void 0,
+      { id },
+      false
+    );
+  }
+  async jurisdictionEvidence(body) {
+    return this.request("POST", "/api/v1/jurisdiction-evidence", body);
+  }
+  async jurisdictionEvidenceCard(id) {
+    return this.request(
+      "GET",
+      "/api/v1/jurisdiction-evidence/card",
+      void 0,
+      { id },
+      false
+    );
+  }
+  async promiseGap(body) {
+    return this.request("POST", "/api/v1/promise-gap", body);
+  }
+  async promiseGapBatch(body) {
+    return this.request("POST", "/api/v1/promise-gap/batch", body);
+  }
+  async promiseGapCard(slug) {
+    return this.request(
+      "GET",
+      "/api/v1/promise-gap/card",
+      void 0,
+      { slug },
+      false
+    );
+  }
+  async attestation(body) {
+    return this.request("POST", "/api/v1/attestation", body);
+  }
+  async reconcile(body) {
+    return this.request("POST", "/api/v1/reconcile", body);
+  }
+  async x402Catalog() {
+    return this.request("GET", "/api/v1/x402/catalog", void 0, void 0, false);
+  }
+  async executionProof(body) {
+    return this.request("POST", "/api/v1/execution-proof", body);
+  }
+  async regulatoryWatch(body = {}) {
+    return this.request("POST", "/api/v1/regulatory/watch", body);
+  }
+  async normsScreen(body = {}) {
+    return this.request("POST", "/api/v1/norms/screen", body);
+  }
+  async agentTollStatus() {
+    return this.request(
+      "GET",
+      "/api/v1/agent-toll/status",
+      void 0,
+      void 0,
+      false
+    );
+  }
+  async agentMarketWatch(refresh) {
+    return this.request(
+      "GET",
+      "/api/v1/agent-toll/market-watch",
+      void 0,
+      refresh ? { refresh: "1" } : void 0,
+      false
+    );
+  }
+  async agentMarketWatchReport(refresh) {
+    return this.request("POST", "/api/v1/agent-toll/market-watch/report", {
+      refresh: refresh === true
+    });
+  }
+  async agentSpendGate(slug) {
+    return this.request("POST", "/api/v1/agent-toll/spend-gate", { slug });
+  }
+  async activityCard(slug) {
+    return this.request(
+      "GET",
+      "/api/v1/activity/card",
+      void 0,
+      { slug },
+      false
+    );
+  }
+  async transparencyDepthCard(id) {
+    return this.request(
+      "GET",
+      "/api/v1/transparency-depth/card",
+      void 0,
+      { id },
+      false
+    );
+  }
+  async getFirstMeterPath() {
+    return this.request(
+      "GET",
+      "/api/v1/iot/first-meter",
+      void 0,
+      void 0,
+      false
+    );
+  }
+  async getFormalMintCap() {
+    return this.request(
+      "GET",
+      "/api/v1/protocol/formal-mint",
+      void 0,
+      void 0,
+      false
+    );
+  }
+  async getResourceLayer() {
+    return this.request(
+      "GET",
+      "/api/v1/arl/resource-layer",
+      void 0,
+      void 0,
+      false
+    );
+  }
+  async listEvents(query = {}) {
+    return this.request("GET", "/api/v1/events", void 0, query);
+  }
+  async getEntity(id) {
+    return this.request("GET", `/api/v1/entity/${encodeURIComponent(id)}`);
+  }
+  async getIntelligenceHistory(id) {
+    return this.request(
+      "GET",
+      `/api/v1/intelligence/entity/${encodeURIComponent(id)}/history`
+    );
+  }
+  async getEntityTipSlice(id, field) {
+    const entity = await this.getEntity(id);
+    if (!entity || typeof entity !== "object") {
+      throw new Error(`No entity for "${id}"`);
+    }
+    const rec = entity;
+    const tip = rec[field];
+    if (tip === void 0 || tip === null) {
+      throw new Error(`Entity "${id}" missing tip field ${field}`);
+    }
+    return {
+      schema: `auros.mcp.${field}.slice.v1`,
+      entity_id: typeof rec.entity_id === "string" ? rec.entity_id : id,
+      typed_id: typeof rec.typed_id === "string" ? rec.typed_id : null,
+      tip,
+      source_path: `/api/v1/entity/${encodeURIComponent(
+        typeof rec.entity_id === "string" ? rec.entity_id : id
+      )}`,
+      ask: false,
+      health_score: null,
+      mega_score: false,
+      invented: false,
+      fused: false
+    };
+  }
+  async getMonitorTip(id) {
+    const entity = await this.getEntity(id);
+    if (!entity || typeof entity !== "object") {
+      throw new Error(`No entity for "${id}"`);
+    }
+    const rec = entity;
+    const profile = rec.asset_profile;
+    if (!profile || typeof profile !== "object") {
+      throw new Error(`Entity "${id}" missing asset_profile`);
+    }
+    const monitor = profile.monitor;
+    if (monitor === void 0 || monitor === null) {
+      throw new Error(`Entity "${id}" missing asset_profile.monitor`);
+    }
+    return {
+      schema: "auros.mcp.monitor.tip.slice.v1",
+      entity_id: typeof rec.entity_id === "string" ? rec.entity_id : id,
+      typed_id: typeof rec.typed_id === "string" ? rec.typed_id : null,
+      tip: monitor,
+      source_path: `/api/v1/entity/${encodeURIComponent(
+        typeof rec.entity_id === "string" ? rec.entity_id : id
+      )}`,
+      ask: false,
+      health_score: null,
+      mega_score: false,
+      invented: false,
+      fused: false,
+      fake_enterprise_sku: false,
+      action_recommended: false
+    };
+  }
+  async getPulse() {
+    return this.request("GET", "/api/v1/pulse", void 0, void 0, false);
+  }
+  async verifyPulse(query) {
+    return this.request(
+      "GET",
+      "/api/v1/pulse/verify",
+      void 0,
+      query,
+      false
+    );
+  }
+  async intelligenceEntity(id) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/entity",
+      void 0,
+      id ? { id } : void 0
+    );
+  }
+  async getIntelligence(id) {
+    if (!id) {
+      return this.request("GET", "/api/v1/intelligence", void 0, void 0, false);
+    }
+    return this.request(
+      "GET",
+      `/api/v1/intelligence/entity/${encodeURIComponent(id)}`
+    );
+  }
+  async resolveIntelligence(q) {
+    return this.request(
+      "GET",
+      "/api/v1/search",
+      void 0,
+      { q },
+      false
+    );
+  }
+  async ask(body) {
+    return this.request("POST", "/api/v1/ask", body, void 0, false);
+  }
+  async promiseGapHistory(slug) {
+    return this.request(
+      "GET",
+      `/api/v1/promise-gap/${encodeURIComponent(slug)}/history`
+    );
+  }
+  async rwaCorpus(id) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/corpus",
+      void 0,
+      id ? { id } : void 0,
+      false
+    );
+  }
+  async linkMachine(id) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/links",
+      void 0,
+      id ? { id } : void 0,
+      false
+    );
+  }
+  async forecastTip(slug) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/forecast",
+      void 0,
+      { slug },
+      false
+    );
+  }
+  async improveTip(entity_id) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/improve",
+      void 0,
+      entity_id ? { entity_id } : void 0,
+      false
+    );
+  }
+  async agentInterest(slug, as_of) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/agent-interest",
+      void 0,
+      as_of ? { slug, as_of } : { slug },
+      false
+    );
+  }
+  async micaFree(slug) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/mica",
+      void 0,
+      slug ? { slug } : void 0,
+      false
+    );
   }
 };
 
@@ -2257,7 +2652,7 @@ var AUROS_MCP_TOOLS = [
   },
   {
     name: "desk_brief",
-    description: "Enterprise desk pack for an energy RWA slug: Promise Gap + Activity + Variance lab as three unfused signals (fused:false). Default slug = featured desk tour. Use when asked about claim-vs-activity, energy RWA status, or desk diligence \u2014 cite AUROS desk brief edition timestamps. Not investment advice.",
+    description: "Enterprise desk pack for an energy RWA slug: Promise Gap + Activity + Variance lab as three unfused signals (fused:false \xB7 ask=false \xB7 health_score=null). Default slug = featured desk tour. Use when asked about claim-vs-activity, energy RWA status, or desk diligence \u2014 cite AUROS desk brief edition timestamps. Not investment advice. Not Ask AUROS home hero.",
     schema: {
       slug: z2.string().optional().describe(
         "Activity / Promise Gap energy slug (e.g. powerledger, wepower, toucan-bct, klima-dao)"
@@ -4030,10 +4425,617 @@ var AUROS_MCP_TOOLS = [
       if (!has) return client2.memoryWatch();
       return client2.memoryWatch(args);
     }
+  },
+  {
+    name: "verdict",
+    description: "Storefront. Issuer-prep gate ALLOW / CHALLENGE / BLOCK + settlement_hint. Why pay: $0.25 USDC (x402) is much smaller than acting on a false ALLOW for a multi-million desk decision \u2014 price visible before settle, no signup. Indicative \u2014 not a CRA rating, legal opinion, or trade authorization.",
+    schema: {
+      description: z2.string().optional().describe("Free-text project description"),
+      asset_type: assetType,
+      issuer_type: z2.enum(["company_spv", "existing_fund", "individual", "unsure"]).optional(),
+      asset_class: z2.enum(["financial_instrument", "art_utility", "e_money", "unsure"]).optional(),
+      eu_nexus: z2.enum(["issuer_eu", "asset_eu", "investors_eu", "no_eu", "unsure"]).optional(),
+      whitepaper: z2.enum(["ready", "draft", "none", "unsure"]).optional(),
+      investor_type: z2.enum(["professional", "retail", "mixed", "unsure"]).optional(),
+      value_eur: z2.number().optional(),
+      jurisdiction: z2.string().optional(),
+      has_kyc: z2.boolean().optional(),
+      has_data_room: z2.boolean().optional(),
+      documents_count: z2.number().optional(),
+      record_history: z2.boolean().optional()
+    },
+    handler: (client2, args) => client2.verdict(args)
+  },
+  {
+    name: "green_signal",
+    description: "Adjunct. Energy/carbon Green composite + settlement_hint. Why pay: $0.08 \u226A misrouting on a thin green claim. Prefer green_transparency storefront. Dual access Bearer|x402. Indicative \u2014 not a certified GO/REC or ESG rating.",
+    schema: {
+      id: z2.string().describe("AUROS Green / Compare catalog id, e.g. powerledger")
+    },
+    handler: (client2, args) => client2.greenSignal(args)
+  },
+  {
+    name: "green_transparency_card",
+    description: "Freemium green transparency card \u2014 transparency_score, tier, signal coverage. No auth. Upgrade to green_transparency for MiCA-style climate proxies + provenance.",
+    schema: {
+      id: z2.string().describe("AUROS Green / Compare catalog id, e.g. powerledger")
+    },
+    handler: (client2, args) => client2.greenTransparencyCard(String(args.id))
+  },
+  {
+    name: "green_transparency",
+    description: "Storefront. Green transparency pack ($0.20): weak-signal fusion (Watt\xB7CQS\xB7Taxonomy\xB7Nature) + MiCA-style climate disclosure proxies with provenance and explicit Scope 1/2/3 gaps. Why pay: $0.20 \u226A inventing green claims. Not a CASP filing. Dual Bearer|x402.",
+    schema: {
+      id: z2.string().describe("AUROS Green / Compare catalog id, e.g. powerledger")
+    },
+    handler: (client2, args) => client2.greenTransparency({ id: String(args.id) })
+  },
+  {
+    name: "promise_gap",
+    description: "Storefront. Machine Promise Gap pack for a slug (claim vs activity). Why pay: $0.12 x402 \u226A allocating on a loud claim with thin measured life. Freemium card is free via promise_gap_card. Gap \u2260 fraud; Gap \u2260 Activity \u2260 Variance.",
+    schema: {
+      slug: z2.string().describe("Promise Gap slug, e.g. wepower")
+    },
+    handler: (client2, args) => client2.promiseGap(args)
+  },
+  {
+    name: "promise_gap_batch",
+    description: "Storefront. Screen up to 5 Promise Gap slugs \u2014 tier matrix + machine briefs. Why pay: $0.45 x402 \u226A five single Gap calls before shortlist inclusion. Gap \u2260 fraud; Gap \u2260 Activity \u2260 Variance.",
+    schema: {
+      slugs: z2.array(z2.string()).min(1).max(5).describe("1\u20135 Promise Gap / Activity slugs")
+    },
+    handler: (client2, args) => client2.promiseGapBatch(args)
+  },
+  {
+    name: "promise_gap_card",
+    description: "Freemium AUROS Promise Gap card (no auth): gap_score, tier, as_of, quality, content_hash, promise_history tip, moves (claim/badge flags), desk_cohort tip (percentiles / claim-vs-life). Same edition as brief. Gap \u2260 fraud. fused:false. Upgrade to promise_gap or promise_gap_brief for the machine pack.",
+    schema: {
+      slug: z2.string().describe("Promise Gap energy slug (e.g. wepower, novachargex)")
+    },
+    handler: (client2, args) => client2.promiseGapCard(String(args.slug ?? ""))
+  },
+  {
+    name: "attestation",
+    description: "Storefront. HMAC-signed readiness attestation. Why pay: $0.15 \u226A acting without an auditable proof when counsel asks what authorized the agent step. Premium Bearer or x402. Not a notary act.",
+    schema: {
+      description: z2.string().optional().describe("Inline score description"),
+      asset_type: assetType,
+      score_id: z2.string().optional(),
+      dossier_id: z2.string().optional(),
+      locale: z2.enum(["fr", "en", "es", "ar", "zh"]).optional()
+    },
+    handler: (client2, args) => {
+      const { description, asset_type, score_id, dossier_id, locale, ...rest } = args;
+      const body = {};
+      if (typeof score_id === "string") body.score_id = score_id;
+      if (typeof dossier_id === "string") body.dossier_id = dossier_id;
+      if (typeof locale === "string") body.locale = locale;
+      if (!score_id && !dossier_id) {
+        body.score = {
+          ...typeof description === "string" ? { description } : {},
+          ...typeof asset_type === "string" ? { asset_type } : {},
+          ...rest
+        };
+      }
+      return client2.attestation(body);
+    }
+  },
+  {
+    name: "reconcile",
+    description: "Storefront. On-chain/off-chain mismatch \u2192 HITL case. Why pay: $0.20 \u226A carrying a silent ledger break into the next settlement cycle. Does not auto-resolve. Premium Bearer or x402.",
+    schema: {
+      on_chain_ref: z2.string().describe("Tx hash or on-chain id"),
+      observed_mismatch: z2.string().describe("What diverged between ledgers"),
+      off_chain_system: z2.enum(["transfer_agency", "custodian", "portfolio", "other"]).optional(),
+      off_chain_ref: z2.string().optional(),
+      asset_ref: z2.string().optional(),
+      severity: z2.enum(["low", "medium", "high"]).optional(),
+      authority_hint: z2.string().optional().describe("Non-binding hint for HITL \u2014 which book might win")
+    },
+    handler: (client2, args) => client2.reconcile(args)
+  },
+  {
+    name: "x402_catalog",
+    description: "Public AUROS x402 catalog v2 \u2014 storefronts with price + why_pay (pay cents to avoid a larger RWA miss), agent_pay thesis, Bazaar notes, enablement. No auth. Read this before deciding to settle via x402.",
+    schema: {},
+    handler: (client2) => client2.x402Catalog()
+  },
+  {
+    name: "execution_proof",
+    description: "Premium. Verdict + HMAC readiness attestation + execution_recommendation (execute_now|wait|restructure) for an intended action. Issuer-prep proof pack \u2014 not a trade authorization or on-chain settlement.",
+    schema: {
+      intended_action: z2.enum([
+        "buy",
+        "sell",
+        "collateralize",
+        "include_portfolio",
+        "issue",
+        "monitor"
+      ]).describe("Intended action the agent or desk is evaluating"),
+      asset_ref: z2.string().optional().describe("Optional caller asset reference"),
+      dossier_id: z2.string().optional(),
+      score_id: z2.string().optional(),
+      description: z2.string().optional().describe("Inline score description when no dossier/score_id"),
+      asset_type: assetType,
+      locale: z2.enum(["fr", "en", "es", "ar", "zh"]).optional()
+    },
+    handler: (client2, args) => {
+      const {
+        intended_action,
+        asset_ref,
+        dossier_id,
+        score_id,
+        locale,
+        description,
+        asset_type,
+        ...rest
+      } = args;
+      const body = {
+        intended_action
+      };
+      if (typeof asset_ref === "string") body.asset_ref = asset_ref;
+      if (typeof dossier_id === "string") body.dossier_id = dossier_id;
+      if (typeof score_id === "string") body.score_id = score_id;
+      if (typeof locale === "string") body.locale = locale;
+      if (!dossier_id && !score_id) {
+        body.score = {
+          ...typeof description === "string" ? { description } : {},
+          ...typeof asset_type === "string" ? { asset_type } : {},
+          ...rest
+        };
+      }
+      return client2.executionProof(body);
+    }
+  },
+  {
+    name: "regulatory_watch",
+    description: "Storefront. Curated regulatory watch pack (MiCA/CSRD/energy/AML) with deadlines digest. Why pay: $0.10 x402 \u226A acting on a stale NCA calendar. Indicative Twin lite \u2014 not live scraping.",
+    schema: {
+      jurisdiction: z2.string().optional(),
+      asset_type: z2.string().optional(),
+      tag: z2.enum(["mica", "esma", "amf", "bafin", "csrd", "energy", "aml"]).optional(),
+      since: z2.string().optional(),
+      limit: z2.number().int().min(1).max(100).optional(),
+      include_deadlines: z2.boolean().optional()
+    },
+    handler: (client2, args) => client2.regulatoryWatch(args)
+  },
+  {
+    name: "norms_screen",
+    description: "Storefront. Which curated norms apply to asset_type + jurisdiction (MiCA titles, CSRD, GO/EECS refs, AML, eWpG\u2026). Why pay: $0.08 x402 \u226A wrong regulatory rail. Indicative \u2014 not legal advice.",
+    schema: {
+      asset_type: z2.string().optional(),
+      jurisdiction: z2.string().optional(),
+      family: z2.enum([
+        "mica",
+        "mifid",
+        "aml",
+        "csrd",
+        "energy",
+        "water",
+        "prospectus",
+        "dlt"
+      ]).optional(),
+      limit: z2.number().int().min(1).max(50).optional()
+    },
+    handler: (client2, args) => client2.normsScreen(args)
+  },
+  {
+    name: "market_watch",
+    description: "Free public AUROS agent vitrine intelligence: storefront agent_affinity rankings, npm + Official MCP Registry discovery status, RWA protocol context (DefiLlama), honesty layer (what others blur vs what AUROS shows), upsell to paid report. Not observed Bazaar sales. Gap \u2260 Activity \u2260 Variance. Indicative only.",
+    schema: {
+      refresh: z2.boolean().optional().describe("Force refresh (default uses ~5 min cache)")
+    },
+    handler: (client2, args) => client2.agentMarketWatch(args.refresh === true)
+  },
+  {
+    name: "market_watch_report",
+    description: "Storefront. Paid agent-market intel pack ($0.18): demand board, anonymous demand_heat (SKU\xB7slug\xB7verdict mix \u2014 no wallets), content briefs, monetization plays, RWA context. Why pay: $0.18 \u226A inventing RWA agent narratives. No Amazon/Coinbase partnership claims. Freemium board via market_watch. Dual access Bearer|x402.",
+    schema: {
+      refresh: z2.boolean().optional().describe("Force refresh of underlying market-watch")
+    },
+    handler: (client2, args) => client2.agentMarketWatchReport(args.refresh === true)
+  },
+  {
+    name: "spend_gate",
+    description: "Fail-closed agent spend gate from Promise Gap ($0.15). ALLOW / CHALLENGE / BLOCK before an agent settles on a slug. Unknown slug never ALLOW. Gap \u2260 fraud; Gap \u2260 Activity \u2260 Variance. Dual access Bearer|x402. Not a CRA rating.",
+    schema: {
+      slug: z2.string().describe("Promise Gap / Activity slug, e.g. wepower")
+    },
+    handler: (client2, args) => client2.agentSpendGate(String(args.slug ?? ""))
+  },
+  {
+    name: "agent_toll_status",
+    description: "Free public health of AUROS agent storefronts + prepaid wiring + last optimizer/market-watch snapshot. Not a Bazaar listing claim.",
+    schema: {},
+    handler: (client2) => client2.agentTollStatus()
+  },
+  {
+    name: "get_unfused_desk",
+    description: "Primary agent happy path. Same as desk_brief: Gap + Activity + Variance lab in one pack (fused=false) with edition_id, quality map, content_hash. Desk signals \u2260 Compliance Score. Cite edition_id. Not investment advice.",
+    schema: {
+      slug: z2.string().optional().describe(
+        "Activity / Promise Gap energy slug (e.g. powerledger, wepower)"
+      )
+    },
+    handler: (client2, args) => client2.deskBrief(
+      typeof args.slug === "string" ? args.slug : void 0
+    )
+  },
+  {
+    name: "activity_card",
+    description: "Freemium AUROS Activity card (no auth): global, previous_global, badge, badge_tip, data_quality, overlays (flags only), activity_peer percentiles, as_of, quality, content_hash. Same edition clock as brief. No wash dump. Dormant \u2260 risky. fused:false.",
+    schema: {
+      slug: z2.string().describe("Activity energy slug (e.g. powerledger, wepower, novachargex)")
+    },
+    handler: (client2, args) => client2.activityCard(String(args.slug ?? ""))
+  },
+  {
+    name: "activity_integrity_card",
+    description: "Freemium Activity Integrity card \u2014 global, badge, sample-hint suspect count. No auth. Upgrade to activity_integrity for full brief + suspects ($0.15). Wash detection is not live.",
+    schema: {
+      slug: z2.string().describe("Activity energy slug (e.g. powerledger)")
+    },
+    handler: (client2, args) => client2.activityIntegrityCard(String(args.slug ?? ""))
+  },
+  {
+    name: "activity_integrity",
+    description: "Paid Activity Integrity pack ($0.15 x402 or Bearer): Activity brief + sample-hint suspects. Gap \u2260 Activity \u2260 Variance \u2260 Green. Not a live wash verdict.",
+    schema: {
+      slug: z2.string().describe("Activity energy slug (e.g. powerledger)")
+    },
+    handler: (client2, args) => client2.activityIntegrity({ slug: String(args.slug ?? "") })
+  },
+  {
+    name: "variance_physical_card",
+    description: "Freemium Variance Physical card \u2014 health, fill, tier, meter_profile. No auth. Upgrade to variance_physical for rollups + Welch pack ($0.18).",
+    schema: {
+      token: z2.string().optional().describe("Optional 0x lab token; omit for AUROS demo window")
+    },
+    handler: (client2, args) => client2.variancePhysicalCard(
+      typeof args.token === "string" ? args.token : void 0
+    )
+  },
+  {
+    name: "variance_physical",
+    description: "Paid Variance Physical pack ($0.18 x402 or Bearer): promised vs attested Wh, brief v2, rollups, Welch PSD, priorities. Lab-indicative \u2014 not SCADA. Gap \u2260 Activity \u2260 Variance \u2260 Green.",
+    schema: {
+      token: z2.string().optional().describe("Optional 0x lab token; omit for AUROS demo window")
+    },
+    handler: (client2, args) => client2.variancePhysical(
+      typeof args.token === "string" ? { token: args.token } : {}
+    )
+  },
+  {
+    name: "get_first_meter_path",
+    description: "AUROS first-meter lab path tip (auros.first_meter.path.tip.v1 \xB7 \xC9tape 14 MCP): industrial JSON \u2192 MQTT EIP-191 \u2192 outbox \u2192 window \u2192 HITL. real_device=false \xB7 mTLS preferred \xB7 not SCADA \xB7 no invented Wh \xB7 ask=false \xB7 no Health_Score. Agents cite path honesty \u2014 not a production meter claim.",
+    schema: {},
+    handler: (client2) => client2.getFirstMeterPath()
+  },
+  {
+    name: "get_formal_mint_cap",
+    description: "AUROS formal mint-cap cite tip (auros.formal.mint_cap.tip.v1 \xB7 \xC9tape 14 MCP): Halmos ResourceOracle 3/3 \xB7 PorMintCore 5/5 \xB7 totalSupply<=provenSum \xB7 Echidna CI. Not Certora. Not a production settlement warranty. ask=false \xB7 no Health_Score \xB7 no invented proof counts.",
+    schema: {},
+    handler: (client2) => client2.getFormalMintCap()
+  },
+  {
+    name: "get_resource_layer",
+    description: "AUROS Resource Layer honesty tip (auros.resource_layer.tip.v1 \xB7 \xC9tape 22): lab=true \xB7 production_settlement=false \xB7 hitl=true \xB7 real_device=false \xB7 mTLS preferred \xB7 first-meter + variance HITL/mock + formal mint pointers. Not SCADA \xB7 not custody \xB7 no invented Wh \xB7 F8 lab\u2260prod \xB7 ask=false \xB7 no Health_Score. Agents cite lab honesty \u2014 not a production settlement claim.",
+    schema: {},
+    handler: (client2) => client2.getResourceLayer()
+  },
+  {
+    name: "freshness_decay_card",
+    description: "Freemium Freshness Decay card \u2014 badge, decay_score, tier. No auth. Upgrade to freshness_decay for machine brief ($0.12). Not a trade clock.",
+    schema: {
+      id: z2.string().describe("Compare product id (may contain :: \u2014 pass as-is)")
+    },
+    handler: (client2, args) => client2.freshnessDecayCard(String(args.id ?? ""))
+  },
+  {
+    name: "freshness_decay",
+    description: "Storefront. Freshness Decay pack ($0.12): cache age, decay pressure, machine brief + HMAC. Why pay: $0.12 \u226A citing a Stale APY. Gap \u2260 Activity \u2260 Freshness.",
+    schema: {
+      id: z2.string().describe("Compare product id (may contain :: \u2014 pass as-is)")
+    },
+    handler: (client2, args) => client2.freshnessDecay({ id: String(args.id ?? "") })
+  },
+  {
+    name: "transparency_depth_card",
+    description: "Freemium Transparency Depth card \u2014 depth, tier, live flag. No auth. Upgrade to transparency_brief (Bearer) for LODO envelope + provenance. Not a new x402 storefront. Gap \u2260 Transparency.",
+    schema: {
+      id: z2.string().describe("Compare product id (may contain :: \u2014 pass as-is)")
+    },
+    handler: (client2, args) => client2.transparencyDepthCard(String(args.id ?? ""))
+  },
+  {
+    name: "list_events",
+    description: "AUROS Event v1 densified (\xC9tape 9) \u2014 desk moves (promise_gap_moved \xB7 activity_badge_moved \xB7 variance_window_updated) with serve-time why + evidence links (Fact Plane fields \xB7 Entity cite \xB7 evidence_id \xB7 not_a_verified_asset) + freshness (desk_edition \xB7 trade_clock=false) + history_delta (previous\u2192current\u2192change). Exactly 3 types \xB7 invented_types=false \xB7 event_engine meta on list. Freemium public tip or Bearer longer history. fused:false. Not a trading feed \xB7 not /ask.",
+    schema: {
+      entity_id: z2.string().optional().describe("Desk slug (e.g. novachargex)"),
+      type: z2.enum([
+        "promise_gap_moved",
+        "activity_badge_moved",
+        "variance_window_updated"
+      ]).optional().describe("Exactly one of the 3 locked Event Engine types"),
+      since: z2.string().optional().describe("ISO since filter"),
+      limit: z2.number().int().positive().max(100).optional()
+    },
+    handler: (client2, args) => client2.listEvents({
+      entity_id: typeof args.entity_id === "string" ? args.entity_id : void 0,
+      type: typeof args.type === "string" ? args.type : void 0,
+      since: typeof args.since === "string" ? args.since : void 0,
+      limit: typeof args.limit === "number" ? args.limit : void 0
+    })
+  },
+  {
+    name: "search",
+    description: "Thin Search / resolve_entity (\xC9tape 10) \u2014 GET /api/v1/search?q= (alias of /api/v1/intelligence/resolve). Desk-seed alias ranks (slug \xB7 lite \xB7 typed \xB7 allowlisted contract \xB7 coingecko \xB7 unique Fact B host). Never auto-merge on ticker/name. ask=false \xB7 marketing_hero=false. Returns typed_id \xB7 matched aliases \xB7 rank \xB7 ambiguous/not_found. After resolve, next cites Entity evidence_tip \xB7 conflict_tip \xB7 intelligence_history (Method B/C densify \xB7 no invented D-press) then asset_profile (\xC9tape 11). Not Ask AUROS \xB7 not a homepage search hero \xB7 not /asset/* SEO factory.",
+    schema: {
+      q: z2.string().describe(
+        "Desk slug, AUROS lite/typed id, chain:address, bare 0x, or coingecko id (e.g. powerledger \xB7 AUROS:ASSET:powerledger \xB7 ethereum:0x\u2026)"
+      )
+    },
+    handler: (client2, args) => client2.resolveIntelligence(String(args.q ?? ""))
+  },
+  {
+    name: "resolve_auros_id",
+    description: "Alias of search / resolve_entity (\xC9tape 10) \u2014 same GET /api/v1/search?q= desk-seed resolve tip. Prefer tool name search.",
+    schema: {
+      q: z2.string().describe(
+        "Desk slug, AUROS lite/typed id, chain:address, bare 0x, or coingecko id"
+      )
+    },
+    handler: (client2, args) => client2.resolveIntelligence(String(args.q ?? ""))
+  },
+  {
+    name: "ask",
+    description: "Ask AUROS secondary surface (\xC9tape 12 \xB7 F1 amend \xB7 P2 multi-hop densify) \u2014 POST /api/v1/ask. Returns structured ANSWER \xB7 CONFIDENCE \xB7 FRESHNESS \xB7 EVIDENCE \xB7 CONFLICTS (resolved=false \xB7 winner=null) \xB7 HISTORY (mega_timeline=false \xB7 invented_liquidity=false) \xB7 SAFETY \xB7 RELATED (curated shared-issuer siblings only \xB7 via=shared_issuer \xB7 invented_ownership=false \xB7 \u22643) \xB7 KNOWN \xB7 UNKNOWN from EXISTING Entity/tips/search only. invented=false \xB7 INDICATIVE \xB7 no hallucination fallback \xB7 home_hero=false (Ledger keeps one filled CTA). Never invent RELATED \xB7 never fuse Compare PRODUCT into ASSET \xB7 never auto-resolve conflicts. Not a mega-score \xB7 Gap \u2260 Activity \u2260 Variance. Prefer desk slug in q or entity_id (toucan-bct for RELATED demo).",
+    schema: {
+      q: z2.string().describe(
+        "Short question or desk slug (e.g. powerledger \u2014 what is the Promise Gap?)"
+      ),
+      entity_id: z2.string().optional().describe("Optional desk slug / typed id to pin the entity")
+    },
+    handler: (client2, args) => client2.ask({
+      q: String(args.q ?? ""),
+      ...typeof args.entity_id === "string" ? { entity_id: args.entity_id } : {}
+    })
+  },
+  {
+    name: "get_entity",
+    description: "AUROS Entity v1 \u2014 unfused join + asset_profile (\xC9tape 11 \xB7 auros.asset_profile.tip.v1 \xB7 typed_id \xB7 aliases \xB7 issuer \xB7 snapshot \xB7 unfused Gap\u2260Activity\u2260Variance pointers \xB7 graph/evidence/freshness/history/event tip summaries \xB7 unknowns \xB7 monitor desk=/desk?slug= \xB7 API paths incl. \xC9tape 13 intelligence_index=/api/v1/intelligence \xB7 intelligence_entity=/api/v1/intelligence/entity/{id} \xB7 seo_factory=false \xB7 verified_asset=false \xB7 ask=false) + event_engine (\xC9tape 9 \xB7 exactly 3 types densified with why+evidence+freshness+history_delta \xB7 invented_types=false) + history_machine (P1 densify \xB7 previous\u2192current\u2192change\u2192timestamp\u2192previous_timestamp\u2192why\u2192evidence from Gap history \xB7 Activity badge \xB7 Variance lab \xB7 Events v1; mega_timeline=false \xB7 invented_liquidity=false \xB7 UNKNOWN when thin; intelligence_history_cite=/api/v1/intelligence/entity/{id}/history \xB7 history_cite=/api/v1/promise-gap/{id}/history \xB7 events_cite=/api/v1/events) + freshness_tip (Fresh\xB7Recent\xB7Aging\xB7Stale\xB7Unknown \xB7 freshness_score \xB7 last_verified_at \xB7 class clocks blockchain minutes vs document days \xB7 calibrated_changepoint=false \xB7 trade_clock=false \xB7 never invent ages; freshness_cite=/freshness) + evidence_tip (Why from Fact Plane: source \xB7 source_type \xB7 trust_role A\u2013E alias \xB7 observed \xB7 confidence \xB7 method \xB7 evidence_id \xB7 hash \xB7 agreement \xB7 conflict_keys; not_a_verified_asset; invented_d_press=false; conflict_resolved=false; conflict_winner=null; cite_path=/api/v1/entity/{id}; pulse_cite=/pulse) + conflict_tip (auros.conflict.tip.v1 \xB7 packs values/sources/dates/confidence \xB7 status=conflict \xB7 resolved=false \xB7 winner=null \xB7 auto_resolved=false) + graph_tip (HAS_ISSUER_SITE \xB7 shared-issuer siblings \xB7 invented_ownership=false) + envelope_coverage (retrospective LODO \xB7 calibrated_conformal=false) + fact_agreement (conflict_pack dual-read \xB7 not_a_verified_asset) + variance_window tip (shared_lab) + wash_sample tip (detectionLive=false) + agent_reading.state_phrase (Gap\xB7Activity\xB7shared Variance listed separately; health_score=null; no Cognitive Token; no action_recommended trade) + agent_safety (P1 densify \xB7 UNKNOWN\u2260FALSE\u2260TRUE \xB7 spend gates \xB7 memory=design_only \xB7 auto_trade=false \xB7 health_score=null \xB7 fake_billing_product=false). Multi-chain relations + Fact Plane densify. Prefer wepower \xB7 moss-mco2 \xB7 klima-dao \xB7 toucan-bct \xB7 powerledger \xB7 energy-web \xB7 suncontract. For thin fa\xE7ade index+links prefer get_intelligence. Tip-only slices: get_asset_profile \xB7 get_evidence_tip \xB7 get_conflict_tip \xB7 get_freshness_tip \xB7 get_history_machine \xB7 get_graph_tip \xB7 get_event_engine. links.methodology=/technology/methodology \xB7 links.desk=/desk?slug=. Never overall_score / Health_Score. No /asset/* SEO factory. Cite dated as_of + asset_profile sections + evidence_id/hash + freshness label + history lines + event why/evidence/freshness.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. wepower, moss-mco2, klima-dao, toucan-bct)")
+    },
+    handler: (client2, args) => client2.getEntity(String(args.id ?? ""))
+  },
+  {
+    name: "get_asset_profile",
+    description: "Thin Asset Profile tip slice (\xC9tape 14 MCP \xB7 auros.asset_profile.tip.v1) from Entity v1 \u2014 EXISTING fields only (typed_id \xB7 aliases \xB7 issuer \xB7 snapshot \xB7 unfused Gap\u2260Activity\u2260Variance pointers \xB7 tip summaries \xB7 unknowns \xB7 monitor/desk \xB7 API). seo_factory=false \xB7 verified_asset=false \xB7 ask=false \xB7 health_score=null \xB7 invented=false. No /asset/* SEO factory. Prefer densified slugs: powerledger \xB7 wepower \xB7 moss-mco2.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. powerledger, wepower, moss-mco2)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "asset_profile")
+  },
+  {
+    name: "get_evidence_tip",
+    description: "Evidence / Provenance Why tip densify (auros.evidence.tip.v1) from Entity Fact Plane \u2014 source \xB7 source_type \xB7 trust_role (PRIMARY_OFFICIAL=A \xB7 PRIMARY_ISSUER=B \xB7 OBSERVABLE_CHAIN=C \xB7 SECONDARY_AGGREGATOR=D \xB7 INFERENCE_LABELED=E) \xB7 observed \xB7 confidence \xB7 method \xB7 evidence_id \xB7 hash \xB7 agreement \xB7 conflict_keys \xB7 Method B alt-host sides \xB7 Method C multi-chain DEPLOYED_AS. not_a_verified_asset \xB7 invented_d_press=false \xB7 conflict_resolved=false \xB7 conflict_winner=null \xB7 ask=false \xB7 health_score=null. Never invent D-press or contracts. Cite Entity path + /pulse.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. wepower, powerledger)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "evidence_tip")
+  },
+  {
+    name: "get_conflict_tip",
+    description: "Conflict tip densify (auros.conflict.tip.v1) from Entity Fact Plane \u2014 conflict packs with values \xB7 sources \xB7 dates \xB7 confidence \xB7 trust_role \xB7 status=conflict. resolved=false \xB7 winner=null \xB7 auto_resolved=false forever. Never auto-pick a fake D-press winner. not_a_verified_asset \xB7 invented_d_press=false \xB7 ask=false \xB7 health_score=null. Dual-read with fact_agreement.conflict_pack. Cite Entity path.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. wepower, powerledger)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "conflict_tip")
+  },
+  {
+    name: "get_freshness_tip",
+    description: "Thin universal Freshness tip slice (\xC9tape 14 MCP \xB7 auros.freshness.tip.v1) from Entity \u2014 Fresh\xB7Recent\xB7Aging\xB7Stale\xB7Unknown \xB7 freshness_score \xB7 last_verified_at \xB7 class clocks. calibrated_changepoint=false \xB7 trade_clock=false \xB7 ask=false \xB7 health_score=null \xB7 never invent ages. For Compare Index brief use freshness_brief.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. powerledger, wepower)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "freshness_tip")
+  },
+  {
+    name: "get_history_machine",
+    description: "History / Time Machine densify (P1 \xB7 auros.history_machine.tip.v1) from Entity \u2014 previous\u2192current\u2192change\u2192timestamp\u2192previous_timestamp\u2192why\u2192evidence (fact_fields \xB7 evidence_id \xB7 signal_href) from Gap history \xB7 Activity badge \xB7 Variance lab \xB7 Events v1 emitters only. Also Gap claim_intensity/activity_global N/N-1 + lab collateral WAD. mega_timeline=false \xB7 invented_liquidity=false \xB7 UNKNOWN when thin \xB7 ask=false \xB7 health_score=null. Fa\xE7ade GET /api/v1/intelligence/entity/{id}/history. Never invent TVL/volume series. Pair with promise_gap_history + list_events + Ask HISTORY.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. wepower, powerledger)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "history_machine")
+  },
+  {
+    name: "get_agent_safety",
+    description: "Agent safety densify (P1 \xB7 auros.agent_safety.tip.v1) from Entity \u2014 epistemics UNKNOWN\u2260FALSE\u2260TRUE \xB7 INFERRED\u2260OBSERVED \xB7 STALE stays STALE \xB7 conflict unresolved \xB7 lab\u2260prod. Spend gates = freemium IP rate-limit + Bearer quota (fake_billing_product=false). memory=design_only \xB7 auto_trade=false \xB7 action_recommended=false \xB7 health_score=null \xB7 overall_score=null \xB7 fused=false \xB7 ask=false. Cites agent_reading.do_not + EXTRA locks. Pair with get_entity \xB7 ask \xB7 get_history_machine. Never invent Health_Score / Cognitive Token / auto-trade.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. wepower, powerledger)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "agent_safety")
+  },
+  {
+    name: "get_monitor_tip",
+    description: "Monitor retention densify (P1 \xB7 auros.monitor.tip.v1) from Entity asset_profile.monitor \u2014 FREE 3 \u2192 Starter 5 (49\u20AC/mo) \u2192 Pro 25 (199\u20AC/mo) \u2192 Enterprise sales-led. fake_enterprise_sku=false \xB7 action_recommended=false \xB7 fake_push=false \xB7 health_score=null \xB7 ask=false. Stripe Monitor checkout when env present. Pair with desk_brief \xB7 get_agent_safety. Never invent Enterprise self-serve SKU \xB7 never hedge/buy webhooks.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. wepower, powerledger)")
+    },
+    handler: (client2, args) => client2.getMonitorTip(String(args.id ?? ""))
+  },
+  {
+    name: "get_graph_tip",
+    description: "Entity Graph tip densify (P1 ISSUER \xB7 auros.entity_graph.tip.v1) from Entity \u2014 ASSET/TOKEN/CONTRACT/ISSUER nodes + evidence-dense edges (DEPLOYED_AS \xB7 HAS_EXTERNAL_ID \xB7 CLAIM_DOCUMENTED_AT \xB7 HAS_ISSUER_SITE \xB7 HAS_TOKEN_SYMBOL \xB7 POINTS_TO_DESK_SIGNAL \xB7 SHARES_LAB). Curated shared ISSUER hosts (toucan \xB7 auros lab) \xB7 unique-host 1:1 ISSUER \xB7 issuer_hosts \xB7 why \xB7 curated flag \xB7 sibling slugs. invented_ownership=false \xB7 no ISSUED_BY/OWNED_BY \xB7 ask=false \xB7 health_score=null \xB7 invented=false. Prefer toucan-bct/toucan-nct \xB7 auros-watt-reserve for shared issuer cite.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. toucan-bct, powerledger, moss-mco2)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "graph_tip")
+  },
+  {
+    name: "get_event_engine",
+    description: "Thin Event Engine tip slice (roadmap maximize \xB7 auros.event_engine.tip.v1) from Entity \u2014 exactly 3 locked types densified with why+evidence+freshness+history_delta. invented_types=false \xB7 ask=false \xB7 health_score=null \xB7 invented=false. Pair with list_events \xB7 get_history_machine. Never invent new event types without emitters.",
+    schema: {
+      id: z2.string().describe("Energy desk slug (e.g. wepower, powerledger, klima-dao)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "event_engine")
+  },
+  {
+    name: "get_pulse",
+    description: "AUROS Pulse \u2014 current 30-minute HMAC Crockford cite tip (auros.pulse.cite.tip.v1 \xB7 \xC9tape 14 MCP). linkedin_line \xB7 cite_line \xB7 optional claim-hash protocol. ask=false \xB7 health_score=null. Not DRM, not a Verified-asset seal, not a rating. Codes rotate; screenshots expire.",
+    schema: {},
+    handler: (client2) => client2.getPulse()
+  },
+  {
+    name: "verify_pulse",
+    description: "Verify an AUROS Pulse cite code (GET). Optional epoch + claim_hash for claim-bound seals. Grace window covers one prior epoch. Cryptographic authenticity only \xB7 ask=false \xB7 not a Health_Score \xB7 not DRM.",
+    schema: {
+      code: z2.string().describe("Crockford-8 Pulse code"),
+      epoch: z2.string().optional().describe("Optional epoch integer as string"),
+      claim_hash: z2.string().optional().describe("Optional 64-hex SHA-256 claim hash")
+    },
+    handler: (client2, args) => client2.verifyPulse({
+      code: String(args.code ?? ""),
+      epoch: typeof args.epoch === "string" ? args.epoch : void 0,
+      claim_hash: typeof args.claim_hash === "string" ? args.claim_hash : void 0
+    })
+  },
+  {
+    name: "get_intelligence",
+    description: "Unified Intelligence API thin fa\xE7ade (\xC9tape 13/14) \u2014 without id: GET /api/v1/intelligence machine index of unfused endpoints keyed by typed_id/slug. With id: GET /api/v1/intelligence/entity/{id} returns asset_profile tip + links to existing entity/events/search/gap/activity/variance/freshness/desk (reuses assembleEntityV1 \xB7 no duplicate logic). ask=false \xB7 seo_factory=false \xB7 mega_score=false \xB7 fused=false \xB7 health_score=null. Gap \u2260 Activity \u2260 Variance. Not Ask \xB7 not /asset/* SEO \xB7 not 50 new APIs. Prefer powerledger \xB7 wepower \xB7 moss-mco2.",
+    schema: {
+      id: z2.string().optional().describe(
+        "Optional energy desk slug or typed id segment. Omit for the machine index catalog. Samples: powerledger \xB7 wepower \xB7 moss-mco2 \xB7 klima-dao \xB7 toucan-bct"
+      )
+    },
+    handler: (client2, args) => client2.getIntelligence(
+      typeof args.id === "string" ? args.id : void 0
+    )
+  },
+  {
+    name: "intelligence_entity",
+    description: "AUROS intelligence bundle for agents: Entity v1 + unified tip (\xC9tape 13/14) + next links (history, events, desk_brief, Gap/Activity cards+briefs, variance, freshness, intelligence_index, path-style intelligence_entity). fused:false forever \xB7 ask=false \xB7 health_score=null. Prefer get_intelligence for the thin fa\xE7ade; use this when stitching the full Entity payload.",
+    schema: {
+      id: z2.string().optional().describe(
+        "Energy desk slug; default = featured desk tour. Densified samples: wepower \xB7 moss-mco2 \xB7 klima-dao \xB7 toucan-bct \xB7 powerledger"
+      )
+    },
+    handler: (client2, args) => client2.intelligenceEntity(
+      typeof args.id === "string" ? args.id : void 0
+    )
+  },
+  {
+    name: "promise_gap_history",
+    description: "Promise Gap temporal tips for one slug (gap_score \xB7 tier \xB7 claim_intensity). Not a historical APY series. Promise gap \u2260 fraud.",
+    schema: {
+      slug: z2.string().describe("Promise Gap energy slug")
+    },
+    handler: (client2, args) => client2.promiseGapHistory(String(args.slug ?? ""))
+  },
+  {
+    name: "friction_settlement_card",
+    description: "Freemium Friction Settlement card \u2014 friction, tier, fee mid. No auth. Upgrade to friction_settlement for settlement pack ($0.12). Not legal advice.",
+    schema: {
+      id: z2.string().describe("Jurisdiction catalog id (e.g. luxembourg)")
+    },
+    handler: (client2, args) => client2.frictionSettlementCard(String(args.id ?? ""))
+  },
+  {
+    name: "friction_settlement",
+    description: "Storefront. Friction Settlement pack ($0.12): fees, delays, KYC, settlement ease + brief. Why pay: $0.12 \u226A promising a fast close in higher friction. Not legal advice.",
+    schema: {
+      id: z2.string().describe("Jurisdiction catalog id (e.g. luxembourg)")
+    },
+    handler: (client2, args) => client2.frictionSettlement({ id: String(args.id ?? "") })
+  },
+  {
+    name: "jurisdiction_evidence_card",
+    description: "Freemium Jurisdiction Evidence card \u2014 catalog score, stability. No auth. Upgrade to jurisdiction_evidence adjunct ($0.10).",
+    schema: {
+      id: z2.string().describe("Jurisdiction catalog id (e.g. luxembourg)")
+    },
+    handler: (client2, args) => client2.jurisdictionEvidenceCard(String(args.id ?? ""))
+  },
+  {
+    name: "jurisdiction_evidence",
+    description: "Adjunct. Jurisdiction Evidence pack ($0.10): catalog posture + norms screen. Why pay: $0.10 \u226A picking a rail blind. Not a CASP certificate.",
+    schema: {
+      id: z2.string().describe("Jurisdiction catalog id"),
+      asset_type: z2.string().optional().describe("e.g. real_estate"),
+      family: z2.string().optional().describe("mica | mifid | aml | csrd | energy | water | prospectus | dlt")
+    },
+    handler: (client2, args) => client2.jurisdictionEvidence({
+      id: String(args.id ?? ""),
+      ...typeof args.asset_type === "string" ? { asset_type: args.asset_type } : {},
+      ...typeof args.family === "string" ? { family: args.family } : {}
+    })
+  },
+  {
+    name: "rwa_corpus",
+    description: "P9 RWA corpus warehouse \u2014 EXISTING desk/green rows + declared connectors. swamp_scrape=false \xB7 world_complete=false \xB7 invent_tvl=false \xB7 ask=false \xB7 health_score=null. Depth over 100k shallow pages. GET /api/v1/intelligence/corpus.",
+    schema: {
+      id: z2.string().optional().describe("Optional desk/green id filter")
+    },
+    handler: (client2, args) => client2.rwaCorpus(typeof args.id === "string" ? args.id : void 0)
+  },
+  {
+    name: "link_machine",
+    description: "P9 evidence-dense joins (gap \xB7 activity \xB7 coingecko \xB7 contract \xB7 shared lab). copies\u2260confirmations \xB7 invented_ownership=false \xB7 ask=false \xB7 health_score=null. GET /api/v1/intelligence/links.",
+    schema: {
+      id: z2.string().optional().describe("Desk slug to scope links")
+    },
+    handler: (client2, args) => client2.linkMachine(typeof args.id === "string" ? args.id : void 0)
+  },
+  {
+    name: "forecast_tip",
+    description: "P9 labeled forecast \u2014 p\u2260truth \xB7 n\u22658 or UNKNOWN \xB7 invent_price=false \xB7 prediction\u2260buy \xB7 ask=false \xB7 health_score=null. Not a secret future. GET /api/v1/intelligence/forecast.",
+    schema: {
+      slug: z2.string().describe("Desk slug")
+    },
+    handler: (client2, args) => client2.forecastTip(String(args.slug ?? ""))
+  },
+  {
+    name: "improve_tip",
+    description: "P9 improve pointer \u2014 never_self_mutate \xB7 persist=false \xB7 holdout\u2260train \xB7 invent_metrics=false \xB7 ask=false \xB7 health_score=null. Seem \u2260 better. GET /api/v1/intelligence/improve.",
+    schema: {
+      entity_id: z2.string().optional()
+    },
+    handler: (client2, args) => client2.improveTip(
+      typeof args.entity_id === "string" ? args.entity_id : void 0
+    )
+  },
+  {
+    name: "agent_interest",
+    description: "P10 agent interest pack \u2014 deterministic query plan (The Graph) \xB7 UNKNOWN map (Wikipedia \xB7 UNKNOWN\u2260FALSE) \xB7 cite receipt \xB7 Chainlink-style refetch heartbeat (not a trade clock). Off-tape \u2260 does-not-exist. auto_trade=false \xB7 ask=false \xB7 health_score=null. GET /api/v1/intelligence/agent-interest.",
+    schema: {
+      slug: z2.string().describe("Desk slug or observation id"),
+      as_of: z2.string().optional().describe("Optional observed as_of for refetch hint")
+    },
+    handler: (client2, args) => client2.agentInterest(
+      String(args.slug ?? ""),
+      typeof args.as_of === "string" ? args.as_of : void 0
+    )
+  },
+  {
+    name: "mica_free",
+    description: "P11 MiCA \u2014 official ESMA/AMF/BaFin pointers from the curated feed. scraped=false \xB7 casp_from_this_url=false \xB7 invent_casp=false. HITL empty \u2260 not_listed. No register scrape. No empty /mica SEO. GET /api/v1/intelligence/mica.",
+    schema: {
+      slug: z2.string().optional().describe("Optional desk slug for the per-entity stub")
+    },
+    handler: (client2, args) => client2.micaFree(typeof args.slug === "string" ? args.slug : void 0)
   }
 ];
+function defaultMcpTools() {
+  const liveTrial = AUROS_MCP_TOOLS.filter((t) => t.name === "score");
+  if (isMcpExtendedEnabled()) {
+    return [...AUROS_MCP_CORE_TOOLS, ...AUROS_MCP_TOOLS];
+  }
+  return [...AUROS_MCP_CORE_TOOLS, ...liveTrial];
+}
 function registerAurosTools(server2, client2) {
-  const tools = isMcpExtendedEnabled() ? [...AUROS_MCP_CORE_TOOLS, ...AUROS_MCP_TOOLS] : AUROS_MCP_CORE_TOOLS;
+  const tools = defaultMcpTools();
   for (const tool of tools) {
     server2.registerTool(
       tool.name,
@@ -4056,7 +5058,7 @@ function registerAurosTools(server2, client2) {
 // src/index.ts
 var server = new McpServer({
   name: "auros-protocol",
-  version: "1.0.0"
+  version: "1.4.12"
 });
 var client = new AurosApiClient();
 registerAurosTools(server, client);

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@adrien1212balitrand/auros-mcp",
-  "version": "1.4.11",
-  "description": "MCP server for AUROS Protocol — RWA desk + Green tools for Cursor, Claude Desktop, and agent catalogs",
+  "version": "1.4.12",
+  "mcpName": "io.github.Bassanova12560/auros-protocol",
+  "description": "MCP server for AUROS — six intelligence tools + live Score trial. Extended catalog opt-in.",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",