nirium-mcp 0.6.3 → 0.6.4

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,6 @@
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/MPP paid endpoints to any MCP-compatible AI: Claude, GPT, Cursor, VS Code Copilot, and others.
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.
4
4
 
5
5
  Software-only. This server never holds funds - paid tools sign per-request payments from a Stellar wallet you control via `STELLAR_SECRET_KEY`.
6
6
 
@@ -26,7 +26,7 @@ No install needed - run directly with `npx`, or add to your MCP client config.
26
26
  }
27
27
  ```
28
28
 
29
- `STELLAR_SECRET_KEY` and `NIRIUM_API_KEY` are optional - omit them and the free tools still work; paid (x402/MPP) and authenticated tools will tell you what's missing instead of failing silently.
29
+ `STELLAR_SECRET_KEY` and `NIRIUM_API_KEY` are optional - omit them and the free tools still work; paid x402 (MPP experimental) and authenticated tools will tell you what's missing instead of failing silently.
30
30
 
31
31
  ## Tools
32
32
 
@@ -34,10 +34,10 @@ No install needed - run directly with `npx`, or add to your MCP client config.
34
34
  - `get_market_state` - XLM/USDC price, SDEX spread, base fee, Blend rate, CETES rate
35
35
  - `get_loop_status` - autonomous loop status, scan count, last AI decision
36
36
  - `execute_demo` - dry-run a strategy via real Soroban simulation, no funds moved
37
- - `get_wallet_info` - show the configured x402/MPP wallet and enabled tools
37
+ - `get_wallet_info` - show the configured x402 (MPP experimental) wallet and enabled tools
38
38
  - `get_nodes` - list the execution nodes with live status, custody model and network
39
39
  - `anchor_audit_record` - anchor a hash (or a small JSON record) to IPFS, get back a CID
40
- - `get_reporting_summary` - settled payouts, x402/MPP receipts and anchors for a period
40
+ - `get_reporting_summary` - settled payouts, x402 receipts and anchors for a period
41
41
 
42
42
  **Authenticated - requires `NIRIUM_API_KEY`**
43
43
  - `start_loop` - start the autonomous scanning loop
@@ -72,7 +72,7 @@ Reading a DeFindex vault is free. Changing one needs the key, and ten of these e
72
72
 
73
73
  | Variable | Required | Purpose |
74
74
  |---|---|---|
75
- | `AGENT_API_URL` | No (defaults to `http://127.0.0.1:3001`) | Nirium agent API base URL |
75
+ | `AGENT_API_URL` | No (defaults to `http://127.0.0.1:3002`) | Nirium agent API base URL |
76
76
  | `STELLAR_SECRET_KEY` | For paid tools | Funds x402 and MPP payments |
77
77
  | `NIRIUM_API_KEY` | For `start_loop`/`stop_loop` | Agent API key from [nirium.xyz/keys](https://nirium.xyz/keys) |
78
78
  | `STELLAR_NETWORK` | No (defaults to `testnet`) | `testnet` or `mainnet` |
@@ -90,9 +90,11 @@ Anchor a **hash** of your data rather than the data itself. IPFS content cannot
90
90
  git clone https://github.com/nirium-protocol/nirium
91
91
  cd nirium/packages/mcp
92
92
  npm install
93
- STELLAR_SECRET_KEY=S... AGENT_API_URL=http://localhost:3001 npx tsx src/index.ts
93
+ STELLAR_SECRET_KEY=S... AGENT_API_URL=http://localhost:3002 npx tsx src/index.ts
94
94
  ```
95
95
 
96
+ `viem` is a required (non-optional) peer dependency of `mppx`, which this package depends on - it's listed here as a direct dependency so a plain `npm install` resolves it without an extra manual `npm i viem` step.
97
+
96
98
  ## License
97
99
 
98
100
  Apache-2.0 - see [LICENSE](https://github.com/nirium-protocol/nirium/blob/main/packages/mcp/LICENSE).
package/dist/index.js CHANGED
@@ -21,7 +21,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
21
21
  // (Stellar publishes no open mainnet RPC). Free tools need neither.
22
22
  //
23
23
  // Usage (stdio transport, from source):
24
- // STELLAR_SECRET_KEY=S... AGENT_API_URL=http://localhost:3001 npx tsx src/index.ts
24
+ // STELLAR_SECRET_KEY=S... AGENT_API_URL=http://localhost:3002 npx tsx src/index.ts
25
25
  //
26
26
  // Claude Desktop config (published package):
27
27
  // {
@@ -47,7 +47,7 @@ const stellar_2 = require("@x402/stellar");
47
47
  const client_1 = require("mppx/client");
48
48
  const client_2 = require("@stellar/mpp/charge/client");
49
49
  // ─── Configuration ────────────────────────────────────────────
50
- const API_URL = process.env.AGENT_API_URL || 'http://127.0.0.1:3001';
50
+ const API_URL = process.env.AGENT_API_URL || 'http://127.0.0.1:3002';
51
51
  const STELLAR_KEY = process.env.STELLAR_SECRET_KEY || '';
52
52
  const NIRIUM_API_KEY = process.env.NIRIUM_API_KEY || '';
53
53
  const IS_MAINNET = process.env.STELLAR_NETWORK === 'mainnet';
@@ -220,7 +220,7 @@ server.tool('execute_paid_strategy', 'PAID ($0.25 USDC via x402) — Execute a D
220
220
  headers: { 'Content-Type': 'application/json' },
221
221
  body: JSON.stringify(args),
222
222
  }, paidFetch));
223
- server.tool('get_wallet_info', 'Show the x402 + MPP wallet address and payment configuration for this MCP session. Free.', {}, async () => text({
223
+ server.tool('get_wallet_info', 'Show the x402 (MPP experimental) wallet address and payment configuration for this MCP session. Free.', {}, async () => text({
224
224
  address: STELLAR_PUBLIC_KEY || null,
225
225
  network: STELLAR_NET,
226
226
  rpcUrl: RPC_URL || null,
@@ -267,7 +267,7 @@ server.tool('anchor_audit_record', 'Anchor evidence to IPFS and get back a CID (
267
267
  body: JSON.stringify(args),
268
268
  });
269
269
  });
270
- server.tool('get_reporting_summary', 'Institutional-format summary of settled payouts, x402/MPP payment receipts and IPFS anchors for a period. '
270
+ server.tool('get_reporting_summary', 'Institutional-format summary of settled payouts, x402 payment receipts and IPFS anchors for a period. '
271
271
  + 'Not certified regulatory reporting — filings remain the client\'s responsibility. Free.', {
272
272
  from: zod_1.z.string().optional().describe('ISO start date, e.g. 2026-07-01 (defaults to last 30 days)'),
273
273
  to: zod_1.z.string().optional().describe('ISO end date'),
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "nirium-mcp",
3
- "version": "0.6.3",
4
- "description": "Model Context Protocol server for Nirium - exposes market data, autonomous loop control, and x402/MPP paid signals to any MCP-compatible AI (Claude, GPT, Cursor, VS Code Copilot).",
3
+ "version": "0.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": {
7
7
  "nirium-mcp": "dist/index.js"
@@ -34,15 +34,16 @@
34
34
  "dependencies": {
35
35
  "@modelcontextprotocol/sdk": "^1.27.1",
36
36
  "@stellar/mpp": "^0.7.1",
37
- "@stellar/stellar-sdk": "^14.0.0",
38
- "@x402/core": "^2.17.0",
39
- "@x402/fetch": "^2.17.0",
40
- "@x402/stellar": "^2.17.0",
37
+ "@stellar/stellar-sdk": "^16.3.0",
38
+ "@x402/core": "^2.29.0",
39
+ "@x402/fetch": "^2.29.0",
40
+ "@x402/stellar": "^2.29.0",
41
41
  "mppx": "^0.6.31",
42
+ "viem": "^2.57.16",
42
43
  "zod": "^3.25.0"
43
44
  },
44
45
  "devDependencies": {
45
- "@types/node": "^22.0.0",
46
+ "@types/node": "^25.9.9",
46
47
  "tsx": "^4.19.0",
47
48
  "typescript": "^5.7.0"
48
49
  },