nirium-mcp 0.6.4 → 0.6.6

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,6 +1,8 @@
1
1
  # nirium-mcp
2
2
 
3
- Model Context Protocol server for [Nirium](https://nirium.xyz) - exposes market data, autonomous treasury loop control, and x402 paid endpoints (MPP tools are experimental) to any MCP-compatible AI: Claude, GPT, Cursor, VS Code Copilot, and others.
3
+ Model Context Protocol server for [Nirium](https://nirium.xyz) - lets any MCP-compatible AI (Claude, GPT, Cursor, VS Code Copilot, and others) anchor verifiable receipts to IPFS with Audit Trail, pay x402 endpoints (MPP tools are experimental), read market data and control the treasury loop.
4
+
5
+ Every receipt the `anchor_audit_record` tool returns can be re-checked by anyone with `npx nirium-cli verify <cid>` or at [nirium.xyz/verify](https://nirium.xyz/verify).
4
6
 
5
7
  Software-only. This server never holds funds - paid tools sign per-request payments from a Stellar wallet you control via `STELLAR_SECRET_KEY`.
6
8
 
@@ -51,6 +53,7 @@ No install needed - run directly with `npx`, or add to your MCP client config.
51
53
  **Paid via MPP - requires a funded `STELLAR_SECRET_KEY`**
52
54
  - `get_mpp_signals` - $0.02 USDC - same data and same testnet-only limit as `get_premium_signals`, settled via direct Soroban SAC transfer with no external facilitator
53
55
  - `get_mpp_market` - $0.05 USDC - same as `get_premium_market`, MPP-settled
56
+
54
57
  **Treasury - requires `NIRIUM_API_KEY`**
55
58
 
56
59
  Reading a DeFindex vault is free. Changing one needs the key, and ten of these eleven tools only build an unsigned XDR; you sign it yourself and broadcast it with `submit_treasury_tx`. Only `execute_treasury_rebalance` signs anything, and it does so with Nirium's own key, invite-only while a specific legal question stays open (see below) - everywhere else, Nirium never holds a key that can move your funds.
@@ -59,11 +62,11 @@ Reading a DeFindex vault is free. Changing one needs the key, and ten of these e
59
62
  - `get_treasury_vault` - Read a DeFindex vault's roles, assets and managed funds. Pass `holder` to also get that account's balance in the vault's asset
60
63
  - `get_treasury_vaults` - List DeFindex vaults Nirium has deployed or read, on the current network
61
64
  - `get_treasury_strategy_asset` - Read which asset a DeFindex strategy manages, as declared by the strategy itself - pairs it correctly before deploying a vault
62
- - `deploy_treasury_vault` (builds unsigned XDR) - Build an UNSIGNED XDR to deploy a DeFindex vault. `manager` keeps control (rescue, pause, revoke); Nirium only ever holds `rebalanceManager`, which cannot withdraw or change roles
63
- - `deposit_to_treasury_vault` (builds unsigned XDR) - Build an UNSIGNED XDR to deposit into a DeFindex vault. Sign with `from` and broadcast it with `submit_treasury_tx`
65
+ - `deploy_treasury_vault` (builds unsigned XDR) - Build an UNSIGNED XDR to deploy a DeFindex vault. `manager` keeps control (rescue, pause, revoke); Nirium only ever holds `rebalanceManager`, which cannot withdraw or change roles. On mainnet: invite-only (institutional key).
66
+ - `deposit_to_treasury_vault` (builds unsigned XDR) - Build an UNSIGNED XDR to deposit into a DeFindex vault. Sign with `from` and broadcast it with `submit_treasury_tx`. On mainnet: invite-only (institutional key).
64
67
  - `withdraw_from_treasury_vault` (builds unsigned XDR) - Build an UNSIGNED XDR to withdraw from a DeFindex vault. Omit `shares` to withdraw everything the account holds
65
- - `set_treasury_rebalance_manager` (builds unsigned XDR) - Build an UNSIGNED XDR handing the RebalanceManager role to a new address. Only the vault's current Manager can sign it - the same door that grants Nirium the role also revokes it
66
- - `build_treasury_rebalance` (builds unsigned XDR) - Build an UNSIGNED rebalance XDR, Unwind/Invest between a vault's own strategies only; no other instruction is expressible, and none takes a destination address
68
+ - `set_treasury_rebalance_manager` (builds unsigned XDR) - Build an UNSIGNED XDR handing the RebalanceManager role to a new address. Only the vault's current Manager can sign it - the same door that grants Nirium the role also revokes it. On mainnet: invite-only (institutional key).
69
+ - `build_treasury_rebalance` (builds unsigned XDR) - Build an UNSIGNED rebalance XDR, Unwind/Invest between a vault's own strategies only; no other instruction is expressible, and none takes a destination address. On mainnet: invite-only (institutional key).
67
70
  - `submit_treasury_tx` - Broadcast a treasury XDR you already signed (deploy/deposit/withdraw/rebalance/set-rebalance-manager) and wait for confirmation
68
71
  - `execute_treasury_rebalance` (Nirium signs, invite-only) - Sign and submit a rebalance with Nirium's OWN RebalanceManager key, server-side, and wait for confirmation - the only treasury tool that signs anything itself, and it still cannot withdraw funds. **This is invite-only while a specific legal question stays open**: whether executing on a client's behalf without taking custody still counts as regulated facilitation under Mexican law. Only available where that key actually lives; a receive-only mainnet box returns 501 by design, not a broken 500
69
72
 
package/dist/index.js CHANGED
@@ -319,7 +319,7 @@ server.tool('get_treasury_vaults', 'List DeFindex vaults Nirium has deployed or
319
319
  server.tool('get_treasury_strategy_asset', 'Read which asset a DeFindex strategy manages, as declared by the strategy itself — pairs it correctly before deploying a vault. Free.', {
320
320
  strategyId: zod_1.z.string().describe('Strategy contract id (C...)'),
321
321
  }, async (args) => callJson(`${API_URL}/api/treasury/strategy/${args.strategyId}`));
322
- server.tool('deploy_treasury_vault', "Build an UNSIGNED XDR to deploy a DeFindex vault. `manager` keeps control (rescue, pause, revoke); Nirium only ever holds `rebalanceManager`, which cannot withdraw or change roles. Sign the returned XDR with `caller` and broadcast it with submit_treasury_tx. Requires NIRIUM_API_KEY env var.", {
322
+ server.tool('deploy_treasury_vault', "Build an UNSIGNED XDR to deploy a DeFindex vault. `manager` keeps control (rescue, pause, revoke); Nirium only ever holds `rebalanceManager`, which cannot withdraw or change roles. Sign the returned XDR with `caller` and broadcast it with submit_treasury_tx. Requires NIRIUM_API_KEY env var. On mainnet this is invite-only (institutional key); a free key gets a 403. Open on testnet.", {
323
323
  manager: zod_1.z.string().describe('Stellar account (G...) that owns and controls the vault'),
324
324
  caller: zod_1.z.string().describe('Stellar account (G...) that pays to deploy and signs the returned XDR'),
325
325
  assets: zod_1.z.array(zod_1.z.object({
@@ -339,7 +339,7 @@ server.tool('deploy_treasury_vault', "Build an UNSIGNED XDR to deploy a DeFindex
339
339
  headers: { 'Content-Type': 'application/json', ...authHeaders() },
340
340
  body: JSON.stringify(args),
341
341
  }));
342
- server.tool('deposit_to_treasury_vault', 'Build an UNSIGNED XDR to deposit into a DeFindex vault. Sign with `from` and broadcast it with submit_treasury_tx. Requires NIRIUM_API_KEY env var.', {
342
+ server.tool('deposit_to_treasury_vault', 'Build an UNSIGNED XDR to deposit into a DeFindex vault. Sign with `from` and broadcast it with submit_treasury_tx. Requires NIRIUM_API_KEY env var. On mainnet this is invite-only (institutional key); a free key gets a 403. Open on testnet.', {
343
343
  vault: zod_1.z.string().describe('Vault contract id (C...)'),
344
344
  from: zod_1.z.string().describe('Stellar account (G...) funding the deposit and signing the returned XDR'),
345
345
  amounts: zod_1.z.array(zod_1.z.string()).min(1).describe('One amount per vault asset, in stroops, as strings — an i128 does not survive a JSON number'),
@@ -360,7 +360,7 @@ server.tool('withdraw_from_treasury_vault', 'Build an UNSIGNED XDR to withdraw f
360
360
  headers: { 'Content-Type': 'application/json', ...authHeaders() },
361
361
  body: JSON.stringify(args),
362
362
  }));
363
- server.tool('set_treasury_rebalance_manager', "Build an UNSIGNED XDR handing the RebalanceManager role to a new address. Only the vault's current Manager can sign it — the same door that grants Nirium the role also revokes it. Requires NIRIUM_API_KEY env var.", {
363
+ server.tool('set_treasury_rebalance_manager', "Build an UNSIGNED XDR handing the RebalanceManager role to a new address. Only the vault's current Manager can sign it — the same door that grants Nirium the role also revokes it. Requires NIRIUM_API_KEY env var. On mainnet this is invite-only (institutional key); a free key gets a 403. Open on testnet.", {
364
364
  vault: zod_1.z.string().describe('Vault contract id (C...)'),
365
365
  manager: zod_1.z.string().describe("The vault's current Manager (G...), who must sign the returned XDR"),
366
366
  rebalanceManager: zod_1.z.string().describe('The new RebalanceManager address (G...)'),
@@ -374,7 +374,7 @@ const treasuryInstruction = zod_1.z.object({
374
374
  strategy: zod_1.z.string().describe('Strategy contract id (C...)'),
375
375
  amount: zod_1.z.string().describe('Stroops, as a string — an i128 does not survive a JSON number'),
376
376
  });
377
- server.tool('build_treasury_rebalance', "Build an UNSIGNED rebalance XDR — Unwind/Invest between a vault's own strategies only; no other instruction is expressible, and none takes a destination address. Sign with the vault's RebalanceManager and broadcast it with submit_treasury_tx. Requires NIRIUM_API_KEY env var.", {
377
+ server.tool('build_treasury_rebalance', "Build an UNSIGNED rebalance XDR — Unwind/Invest between a vault's own strategies only; no other instruction is expressible, and none takes a destination address. Sign with the vault's RebalanceManager and broadcast it with submit_treasury_tx. Requires NIRIUM_API_KEY env var. On mainnet this is invite-only (institutional key); a free key gets a 403. Open on testnet.", {
378
378
  vault: zod_1.z.string().describe('Vault contract id (C...)'),
379
379
  instructions: zod_1.z.array(treasuryInstruction).min(1),
380
380
  caller: zod_1.z.string().optional().describe("Defaults to Nirium's configured rebalanceManager address"),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nirium-mcp",
3
- "version": "0.6.4",
3
+ "version": "0.6.6",
4
4
  "description": "Model Context Protocol server for Nirium - exposes market data, autonomous loop control, and x402 paid signals (MPP tools are experimental) to any MCP-compatible AI (Claude, GPT, Cursor, VS Code Copilot).",
5
5
  "main": "dist/index.js",
6
6
  "bin": {