@xrpl-utilities/mcp 0.1.27 → 0.1.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # @xrpl-utilities/mcp
2
2
 
3
3
  [Model Context Protocol](https://modelcontextprotocol.io) server for the
4
- XRPL-Utilities™ portfolio. Exposes the read endpoints of all four
4
+ XRPL-Utilities™ portfolio. Exposes the read endpoints of all five
5
5
  services as MCP tools so AI agents can discover and use them — either
6
6
  locally via stdio (Claude Desktop, MCP Inspector, etc.) or remotely
7
7
  via the hosted endpoint at `mcp.xrpl-utilities.io`.
@@ -10,12 +10,13 @@ via the hosted endpoint at `mcp.xrpl-utilities.io`.
10
10
 
11
11
  | Service | What it does | Tools |
12
12
  |---------------|---------------------------------------------------------|-------|
13
- | **XR-Sentinel** | XRPL wallet activity-pattern classifier (0-100 score, 22-signal catalog, AI narrative) | `xrpl_sentinel_scan`, `xrpl_sentinel_scan_history` |
14
- | **XR-Pulse** | Normalized XRPL signal feed — public-source news + on-chain whale activity + XLS-70/80/81 lifecycle | `xrpl_pulse_recent_events` |
13
+ | **XR-Sentinel** | XRPL wallet activity-pattern classifier (0-100 score, 28-signal catalog incl. account-genesis chain + provenance flags, AI narrative) | `xrpl_sentinel_scan`, `xrpl_sentinel_scan_history` |
14
+ | **XR-Pulse** | Normalized XRPL signal feed — public-source news + on-chain whale activity + XLS-70/80/81 lifecycle + RWA mint/burn flow + AMM-of-RWA pool snapshots | `xrpl_pulse_recent_events` |
15
15
  | **XR-Telemetry** | XRPL macro snapshot — supply, liquidity, AMM, Active Float, Burst Math utility floor | `xrpl_telemetry_snapshot`, `xrpl_telemetry_get_quote`, `xrpl_telemetry_get_status`, `xrpl_telemetry_get_results` |
16
16
  | **XR-Trust** | Directory + drill-down for XRPL permissioned-asset stack (XLS-70/80/81 + XLS-40 DID) | `xrpl_trust_list_domains`, `xrpl_trust_get_domain`, `xrpl_trust_credential_issuers`, `xrpl_trust_recent_events` |
17
+ | **XR-Vault** | Real-world asset tracker for XRPL — per-issuer mint/burn flow, daily circulating snapshots, AMM-of-RWA pool exposure across tokenized treasuries, stablecoins, commercial paper, MMFs, and energy commodities | `xrpl_vault_scan` |
17
18
 
18
- 11 tools total, all read-only. Every paid call is settled via x402 v2
19
+ 12 tools total, all read-only. Every paid call is settled via x402 v2
19
20
  on the XRPL mainnet through the t54 facilitator.
20
21
 
21
22
  ## Auth model
@@ -55,7 +56,7 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
55
56
  }
56
57
  ```
57
58
 
58
- Restart Claude Desktop. The 11 tools should appear with the prefix
59
+ Restart Claude Desktop. The 12 tools should appear with the prefix
59
60
  `xrpl_`. Ask Claude to "scan the wallet rXXX with XR-Sentinel" or
60
61
  "list permissioned domains on XRPL" and the tool calls flow through.
61
62
 
@@ -13,7 +13,7 @@ export const pulse = {
13
13
  label: "XR-Pulse",
14
14
  baseUrl: "https://pulse.xrpl-utilities.io",
15
15
  manifestUrl: "https://pulse.xrpl-utilities.io/agents.json",
16
- knownSchemaVersions: ["1.13.0", "1.14.0", "1.15.0", "1.16.0", "1.16.1", "1.17.0", "1.18.0", "1.19.0", "1.20.0", "1.21.0", "1.21.1", "1.21.2", "1.21.3", "1.22.0", "1.22.1"],
16
+ knownSchemaVersions: ["1.13.0", "1.14.0", "1.15.0", "1.16.0", "1.16.1", "1.17.0", "1.18.0", "1.19.0", "1.20.0", "1.21.0", "1.21.1", "1.21.2", "1.21.3", "1.22.0", "1.22.1", "1.23.0"],
17
17
  tools: [
18
18
  {
19
19
  name: "xrpl_pulse_recent_events",
@@ -1 +1 @@
1
- {"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/services/pulse.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/services/pulse.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@xrpl-utilities/mcp",
3
- "version": "0.1.27",
4
- "description": "Model Context Protocol server for the XRPL-Utilities portfolio: Sentinel (wallet classifier), Pulse (signal feed), Telemetry (supply + utility floor), and Trust (XLS-70/80/81 directory). Exposes each service's read endpoints as MCP tools so AI agents can discover and use them via stdio (Claude Desktop) or HTTP/SSE (hosted at mcp.xrpl-utilities.io). Stateless passthrough — caller provides their own x402 payment header.",
3
+ "version": "0.1.28",
4
+ "description": "Model Context Protocol server for the XRPL-Utilities portfolio: Sentinel (wallet classifier), Pulse (signal feed), Telemetry (supply + utility floor), Trust (XLS-70/80/81 directory), and Vault (RWA tracker). Exposes each service's read endpoints as MCP tools so AI agents can discover and use them via stdio (Claude Desktop) or HTTP/SSE (hosted at mcp.xrpl-utilities.io). Stateless passthrough — caller provides their own x402 payment header.",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "bin": {