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 +8 -5
- package/dist/index.js +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# nirium-mcp
|
|
2
2
|
|
|
3
|
-
Model Context Protocol server for [Nirium](https://nirium.xyz) -
|
|
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.
|
|
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": {
|