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 +8 -6
- package/dist/index.js +4 -4
- package/package.json +8 -7
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
|
|
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 (
|
|
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
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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
|
|
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.
|
|
4
|
-
"description": "Model Context Protocol server for Nirium - exposes market data, autonomous loop control, and x402
|
|
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": "^
|
|
38
|
-
"@x402/core": "^2.
|
|
39
|
-
"@x402/fetch": "^2.
|
|
40
|
-
"@x402/stellar": "^2.
|
|
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": "^
|
|
46
|
+
"@types/node": "^25.9.9",
|
|
46
47
|
"tsx": "^4.19.0",
|
|
47
48
|
"typescript": "^5.7.0"
|
|
48
49
|
},
|