@adrien1212balitrand/auros-mcp 1.4.5 → 1.4.10

package/README.md

@@ -30,6 +30,30 @@ Humans fund [Agent Credits](https://getauros.com/developers/agent-credits) in EU
 
 Gap ≠ Activity ≠ Variance. Indicative only.
 
+## Intelligence densify (Étape 14 · ask secondary · no Health_Score)
+
+| Tool | API / source | Notes |
+|------|--------------|-------|
+| `search` / `resolve_auros_id` | `GET /api/v1/search?q=` | Thin alias resolve · marketing_hero=false |
+| `ask` | `POST /api/v1/ask` | Structured Entity answers · invented=false · not home hero |
+| `get_intelligence` | `GET /api/v1/intelligence` (+ `/entity/{id}`) | Unified façade · mega_score=false |
+| `get_entity` | `GET /api/v1/entity/{id}` | Full unfused join + tips |
+| `get_asset_profile` | Entity `asset_profile` slice | seo_factory=false |
+| `get_evidence_tip` | Entity `evidence_tip` slice | invented_d_press=false |
+| `get_freshness_tip` | Entity `freshness_tip` slice | trade_clock=false |
+| `get_history_machine` | Entity `history_machine` slice | mega_timeline=false |
+| `list_events` | `GET /api/v1/events` | 3 Event Engine types only |
+| `desk_brief` | `GET /api/v1/desk/brief` | Gap ≠ Activity ≠ Variance |
+| `promise_gap_brief` / `activity_brief` / `variance_brief` / `freshness_brief` | briefs | Unfused machine briefs |
+| `get_pulse` / `verify_pulse` | `/api/v1/pulse` | HMAC cite · not a rating |
+| `get_first_meter_path` | `/api/v1/iot/first-meter` | real_device=false |
+| `get_formal_mint_cap` | `/api/v1/protocol/formal-mint` | Not Certora |
+| `get_resource_layer` | `/api/v1/arl/resource-layer` | lab=true · production_settlement=false · hitl=true |
+
+Package **1.4.10** in repo — npm publish is founder-blocked (automation / bypass-2FA token).  
+Founder command: `./scripts/founder-publish-mcp.sh` — see `docs/FOUNDER-MCP-PUBLISH-1.4.10.md`.  
+Do not invent tip data · no invented Wh · F8 lab≠prod.
+
 ## Desk tools (cite AUROS for energy RWA / MiCA)
 
 | Tool | API | Auth |

package/dist/index.js

@@ -29,6 +29,78 @@ var AurosApiClient = class {
   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);
   }
@@ -83,6 +155,24 @@ var AurosApiClient = class {
   async status() {
     return this.request("GET", "/api/v1/status", void 0, void 0, false);
   }
+  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 greenScore(id) {
     return this.request("GET", `/api/green/score/${encodeURIComponent(id)}`, void 0, void 0, false);
   }
@@ -209,6 +299,26 @@ var AurosApiClient = class {
   async activityBrief(slug) {
     return this.request("GET", "/api/v1/activity/brief", void 0, { slug });
   }
+  /** Freemium Activity card — as_of · quality · content_hash (no auth). */
+  async activityCard(slug) {
+    return this.request(
+      "GET",
+      "/api/v1/activity/card",
+      void 0,
+      { slug },
+      false
+    );
+  }
+  /** Freemium Promise Gap card — as_of · quality · content_hash (no auth). */
+  async promiseGapCard(slug) {
+    return this.request(
+      "GET",
+      "/api/v1/promise-gap/card",
+      void 0,
+      { slug },
+      false
+    );
+  }
   async promiseGapBrief(slug) {
     return this.request("GET", "/api/v1/promise-gap/brief", void 0, { slug });
   }
@@ -223,12 +333,143 @@ var AurosApiClient = class {
   async freshnessBrief(id) {
     return this.request("GET", "/api/v1/freshness/brief", void 0, { id });
   }
+  /** First-meter industrial path tip (public · real_device=false). */
+  async getFirstMeterPath() {
+    return this.request(
+      "GET",
+      "/api/v1/iot/first-meter",
+      void 0,
+      void 0,
+      false
+    );
+  }
+  /** Formal mint-cap Halmos/Echidna cite tip (public). */
+  async getFormalMintCap() {
+    return this.request(
+      "GET",
+      "/api/v1/protocol/formal-mint",
+      void 0,
+      void 0,
+      false
+    );
+  }
+  /** Resource Layer honesty tip (public · lab · no production settlement). */
+  async getResourceLayer() {
+    return this.request(
+      "GET",
+      "/api/v1/arl/resource-layer",
+      void 0,
+      void 0,
+      false
+    );
+  }
   async transparencyBrief(id) {
     return this.request("GET", "/api/v1/transparency/brief", void 0, { id });
   }
   async frictionBrief(id) {
     return this.request("GET", "/api/v1/friction/brief", void 0, { id });
   }
+  /** Event v1 list — desk moves (Gap / Activity / Variance lab). */
+  async listEvents(query = {}) {
+    return this.request("GET", "/api/v1/events", void 0, query);
+  }
+  /** Entity v1 unfused join. */
+  async getEntity(id) {
+    return this.request("GET", `/api/v1/entity/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Étape 14 — thin tip slice from Entity v1 (EXISTING fields only).
+   * No invented ages / liquidity / Health_Score. ask=false.
+   */
+  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
+    };
+  }
+  /** Current Pulse HMAC cite (public · no bearer). */
+  async getPulse() {
+    return this.request("GET", "/api/v1/pulse", void 0, void 0, false);
+  }
+  /** Verify a Pulse cite code (optional epoch / claim_hash). */
+  async verifyPulse(query) {
+    return this.request(
+      "GET",
+      "/api/v1/pulse/verify",
+      void 0,
+      query,
+      false
+    );
+  }
+  /** Intelligence bundle — Entity v1 + next links (fused:false). */
+  async intelligenceEntity(id) {
+    return this.request(
+      "GET",
+      "/api/v1/intelligence/entity",
+      void 0,
+      id ? { id } : void 0
+    );
+  }
+  /**
+   * Étape 13 — Unified Intelligence index (public) or entity pack (Bearer).
+   * Without id → GET /api/v1/intelligence catalog.
+   * With id → GET /api/v1/intelligence/entity/{id} (asset_profile tip + links).
+   */
+  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)}`
+    );
+  }
+  /**
+   * Thin AUROS ID resolve (Étape 10) — desk alias ranks.
+   * Public freemium tip — not marketing search hero.
+   */
+  async resolveIntelligence(q) {
+    return this.request(
+      "GET",
+      "/api/v1/search",
+      void 0,
+      { q },
+      false
+    );
+  }
+  /**
+   * Ask AUROS secondary surface — structured Entity answers.
+   * invented=false · INDICATIVE · never home hero (F1).
+   */
+  async ask(body) {
+    return this.request("POST", "/api/v1/ask", body, void 0, false);
+  }
+  /** Promise Gap history tips — not a yield series. */
+  async promiseGapHistory(slug) {
+    return this.request(
+      "GET",
+      `/api/v1/promise-gap/${encodeURIComponent(slug)}/history`
+    );
+  }
   async request(method, path, body, query, auth = true) {
     const params = new URLSearchParams();
     if (query) {
@@ -332,12 +573,28 @@ var AUROS_MCP_TOOLS = [
   },
   {
     name: "green_signal",
-    description: "Storefront. Energy/carbon Green composite + settlement_hint. Why pay: $0.08 \u226A misrouting on a thin green claim. Dual access Bearer|x402. Indicative \u2014 not a certified GO/REC or ESG rating.",
+    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: z.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: z.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: z.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.",
@@ -356,11 +613,11 @@ var AUROS_MCP_TOOLS = [
   },
   {
     name: "promise_gap_card",
-    description: "Freemium public Promise Gap card \u2014 gap_score, tier, activity badge, Verified by AUROS. No auth. Use for embeds/badges; upgrade to promise_gap or promise_gap_brief for the machine pack.",
+    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: z.string().describe("Promise Gap slug, e.g. wepower")
+      slug: z.string().describe("Promise Gap energy slug (e.g. wepower, novachargex)")
     },
-    handler: (client2, args) => client2.promiseGapCard(String(args.slug))
+    handler: (client2, args) => client2.promiseGapCard(String(args.slug ?? ""))
   },
   {
     name: "attestation",
@@ -507,7 +764,7 @@ var AUROS_MCP_TOOLS = [
   },
   {
     name: "checklist",
-    description: "Storefront. Issuer-prep compliance checklist (20+ items) by asset type and jurisdiction. Why pay: $0.10 x402 \u226A a hallucinated diligence list. Indicative \u2014 not legal advice.",
+    description: "Adjunct. Issuer-prep compliance checklist (20+ items) by asset type and jurisdiction. Why pay: $0.10 x402 \u226A a hallucinated diligence list. Prefer friction_settlement storefront for settle path. Indicative \u2014 not legal advice.",
     schema: {
       asset_type: z.enum([
         "real_estate",
@@ -921,21 +1178,43 @@ var AUROS_MCP_TOOLS = [
     },
     handler: (client2, args) => client2.wattsSecondaryList(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). Not observed Bazaar sales. Gap \u2260 Activity \u2260 Variance. Indicative only.",
+    schema: {
+      refresh: z.boolean().optional().describe("Force refresh (default uses ~5 min cache)")
+    },
+    handler: (client2, args) => client2.agentMarketWatch(args.refresh === true)
+  },
+  {
+    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: "desk_brief",
-    description: "Enterprise desk pack v3 for an energy RWA slug: Promise Gap + Activity + Variance lab as three unfused signals with provenance (source\xB7as_of\xB7quality). Variance includes meter_profile and last_2/4/8 window rollups. Default slug = featured desk tour. Cite AUROS edition timestamps. Not investment advice.",
+    description: "Enterprise desk pack v3 for an energy RWA slug (\xC9tape 14 MCP): Promise Gap + Activity + Variance lab as three unfused signals with provenance, rollups, desk_cohort, fact_agreement tip, wash_sample tip, variance_window tip (fused:false + content_hash). ask=false \xB7 health_score=null \xB7 no Cognitive Token \xB7 no action_recommended trade. Prefer densified slugs: wepower \xB7 moss-mco2 \xB7 klima-dao \xB7 toucan-bct. Not a credit rating. Cite AUROS desk brief edition timestamps. Not investment advice \xB7 not Ask AUROS.",
     schema: {
       slug: z.string().optional().describe(
-        "Activity / Promise Gap energy slug (e.g. powerledger, wepower, toucan-bct, klima-dao)"
+        "Activity / Promise Gap energy slug (e.g. wepower, moss-mco2, toucan-bct, klima-dao)"
       )
     },
     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: z.string().describe("Activity energy slug (e.g. powerledger, wepower, novachargex)")
+    },
+    handler: (client2, args) => client2.activityCard(String(args.slug ?? ""))
+  },
   {
     name: "promise_gap_brief",
-    description: "AUROS Promise Gap machine brief for one energy slug: claim intensity vs measured activity, provenance, LODO envelope, drivers, NLI claim_evidence, activity join quality. High gap \u2260 fraud. Never fused with Variance. Cite getauros.com/promise-gap with claim as_of.",
+    description: "AUROS Promise Gap machine brief for one energy slug: claim intensity vs measured activity, provenance, LODO envelope, drivers, NLI claim_evidence, activity join quality, envelope_coverage tip. High gap \u2260 fraud. Never fused with Variance \xB7 ask=false \xB7 no Health_Score. Cite getauros.com/promise-gap with claim as_of.",
     schema: {
       slug: z.string().describe("Promise Gap / Activity energy slug (e.g. wepower, powerledger)")
     },
@@ -943,15 +1222,31 @@ var AUROS_MCP_TOOLS = [
   },
   {
     name: "activity_brief",
-    description: "AUROS Activity Index machine brief for one energy asset slug: score, badge, LODO envelope, provenance, live overlays (CoinGecko depth / allowlisted EVM tokentx), content_hash. Wash detection off. Cite getauros.com/activity with edition UTC.",
+    description: "AUROS Activity Index machine brief for one energy asset slug: score, badge, LODO envelope, live overlays (CoinGecko depth / allowlisted EVM tokentx), wash_sample tip (sample_hint \xB7 detectionLive=false \xB7 unfused), content_hash. Gap \u2260 Activity \u2260 Variance. ask=false \xB7 no Health_Score. Not a certified wash/Sybil verdict. Cite getauros.com/activity with edition UTC.",
     schema: {
       slug: z.string().describe("Activity energy slug (e.g. powerledger, toucan-bct, klima-dao)")
     },
     handler: (client2, args) => client2.activityBrief(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: z.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: z.string().describe("Activity energy slug (e.g. powerledger)")
+    },
+    handler: (client2, args) => client2.activityIntegrity({ slug: String(args.slug ?? "") })
+  },
   {
     name: "variance_brief",
-    description: "AUROS Variance Oracle lab brief v2 (promised vs attested Wh, meter_profile demo|device, provenance, last_2/4/8 rollups, collateral factor, HITL/mock settlement). Physical energy window \u2014 not market Activity and not Promise Gap. Optional token 0x address; default = AUROS lab demo. Not a certified SCADA feed.",
+    description: "AUROS Variance Oracle lab brief + variance_window tip (auros.variance_window.tip.v1 \xB7 silence posture \xB7 history trajectory \xB7 HITL/mock \xB7 mainnet_custody=false \xB7 shared_lab). Physical energy window \u2014 not market Activity and not Promise Gap. ask=false \xB7 no Health_Score \xB7 no invented Wh. Optional token 0x address; default = AUROS lab demo. Not a certified SCADA feed. Pair with get_first_meter_path (real_device=false) + get_resource_layer (production_settlement=false).",
     schema: {
       token: z.string().optional().describe("Optional 0x lab token address; omit for AUROS demo window")
     },
@@ -959,14 +1254,68 @@ var AUROS_MCP_TOOLS = [
       typeof args.token === "string" ? args.token : void 0
     )
   },
+  {
+    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: z.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: z.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: "freshness_brief",
-    description: "Freshness Index machine brief for a Compare product id \u2014 Fresh / Stale / Unknown vs class cache age. Not an on-chain oracle.",
+    description: "Freshness Index machine brief for a Compare product id \u2014 Fresh / Stale / Unknown vs class cache age + pre-changepoint tip (calibrated_changepoint=false \xB7 trade_clock=false). ask=false \xB7 no Health_Score \xB7 never invent ages. Not a trade clock. Not an on-chain oracle. For Entity universal freshness_tip prefer get_freshness_tip.",
     schema: {
       id: z.string().describe("Compare product id (may contain :: \u2014 pass as-is)")
     },
     handler: (client2, args) => client2.freshnessBrief(String(args.id ?? ""))
   },
+  {
+    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: z.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: z.string().describe("Compare product id (may contain :: \u2014 pass as-is)")
+    },
+    handler: (client2, args) => client2.freshnessDecay({ id: String(args.id ?? "") })
+  },
   {
     name: "transparency_brief",
     description: "Transparency Depth machine brief for a Compare product id \u2014 Thin / Partial / Deep completeness of the public record. Not an on-chain oracle.",
@@ -982,6 +1331,206 @@ var AUROS_MCP_TOOLS = [
       id: z.string().describe("Jurisdiction catalog id (e.g. luxembourg, difc, singapore)")
     },
     handler: (client2, args) => client2.frictionBrief(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: z.string().optional().describe("Desk slug (e.g. novachargex)"),
+      type: z.enum([
+        "promise_gap_moved",
+        "activity_badge_moved",
+        "variance_window_updated"
+      ]).optional().describe("Exactly one of the 3 locked Event Engine types"),
+      since: z.string().optional().describe("ISO since filter"),
+      limit: z.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). 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, cite Entity asset_profile (\xC9tape 11). Not Ask AUROS \xB7 not a homepage search hero \xB7 not /asset/* SEO factory.",
+    schema: {
+      q: z.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: z.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) \u2014 POST /api/v1/ask. Returns structured ANSWER \xB7 CONFIDENCE \xB7 FRESHNESS \xB7 EVIDENCE \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). Not a mega-score \xB7 Gap \u2260 Activity \u2260 Variance. Prefer desk slug in q or entity_id.",
+    schema: {
+      q: z.string().describe(
+        "Short question or desk slug (e.g. powerledger \u2014 what is the Promise Gap?)"
+      ),
+      entity_id: z.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 (previous\u2192current\u2192change\u2192timestamp\u2192reason\u2192source from Gap history \xB7 Activity badge \xB7 Variance lab \xB7 Events v1; mega_timeline=false \xB7 invented_liquidity=false \xB7 UNKNOWN when thin; 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 observed \xB7 confidence \xB7 method \xB7 evidence_id \xB7 hash; not_a_verified_asset; invented_d_press=false; cite_path=/api/v1/entity/{id}; pulse_cite=/pulse) + graph_tip (HAS_ISSUER_SITE \xB7 shared-issuer siblings \xB7 invented_ownership=false) + envelope_coverage (retrospective LODO \xB7 calibrated_conformal=false) + fact_agreement (not_a_verified_asset) + variance_window (shared_lab) + wash_sample + agent_reading.state_phrase (Gap\xB7Activity\xB7shared Variance listed separately; health_score=null; no Cognitive Token; no action_recommended trade). 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_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: z.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: z.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: "Thin Evidence / Provenance Why tip slice (\xC9tape 14 MCP \xB7 auros.evidence.tip.v1) from Entity Fact Plane \u2014 source \xB7 source_type \xB7 observed \xB7 confidence \xB7 method \xB7 evidence_id \xB7 hash. not_a_verified_asset \xB7 invented_d_press=false \xB7 ask=false \xB7 health_score=null. Never invent D-press. Cite Entity path + /pulse.",
+    schema: {
+      id: z.string().describe("Energy desk slug (e.g. wepower, powerledger)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "evidence_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: z.string().describe("Energy desk slug (e.g. powerledger, wepower)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "freshness_tip")
+  },
+  {
+    name: "get_history_machine",
+    description: "Thin History / Time Machine tip slice (\xC9tape 14 MCP \xB7 auros.history_machine.tip.v1) from Entity \u2014 previous\u2192current\u2192change\u2192timestamp\u2192reason\u2192source from Gap history \xB7 Activity badge \xB7 Variance lab \xB7 Events v1 emitters only. mega_timeline=false \xB7 invented_liquidity=false \xB7 UNKNOWN when thin \xB7 ask=false \xB7 health_score=null. Never invent TVL/volume series. Pair with promise_gap_history + list_events.",
+    schema: {
+      id: z.string().describe("Energy desk slug (e.g. wepower, powerledger)")
+    },
+    handler: (client2, args) => client2.getEntityTipSlice(String(args.id ?? ""), "history_machine")
+  },
+  {
+    name: "get_graph_tip",
+    description: "Thin Entity Graph tip slice (roadmap maximize \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). invented_ownership=false \xB7 no ISSUED_BY/OWNED_BY \xB7 shared_desk_slugs when curated multi-seed issuer host \xB7 ask=false \xB7 health_score=null \xB7 invented=false. Prefer toucan-bct/toucan-nct for shared issuer cite.",
+    schema: {
+      id: z.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: z.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: z.string().describe("Crockford-8 Pulse code"),
+      epoch: z.string().optional().describe("Optional epoch integer as string"),
+      claim_hash: z.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: z.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: z.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: z.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: z.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: z.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: z.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: z.string().describe("Jurisdiction catalog id"),
+      asset_type: z.string().optional().describe("e.g. real_estate"),
+      family: z.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 } : {}
+    })
   }
 ];
 function registerAurosTools(server2, client2) {
@@ -1007,7 +1556,7 @@ function registerAurosTools(server2, client2) {
 // src/index.ts
 var server = new McpServer({
   name: "auros-protocol",
-  version: "1.0.0"
+  version: "1.4.10"
 });
 var client = new AurosApiClient();
 registerAurosTools(server, client);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adrien1212balitrand/auros-mcp",
-  "version": "1.4.5",
-  "description": "MCP server for AUROS Protocol — RWA agent storefronts (verdict · gap · gap-batch · norms · reg-watch · checklist · attest · reconcile) + desk tools",
+  "version": "1.4.10",
+  "description": "MCP server for AUROS Protocol — RWA intelligence densify (search · entity tips · desk briefs · pulse · first-meter · resource-layer) + agent storefronts",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",