nirium-mcp 0.5.0 → 0.5.1
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 +5 -5
- package/dist/index.js +4 -4
- package/package.json +2 -2
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
|
|
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.
|
|
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
|
|
|
@@ -44,12 +44,12 @@ No install needed — run directly with `npx`, or add to your MCP client config.
|
|
|
44
44
|
- `stop_loop` — stop it
|
|
45
45
|
|
|
46
46
|
**Paid via x402 — requires a funded `STELLAR_SECRET_KEY`**
|
|
47
|
-
- `get_premium_signals` — $0.02 USDC —
|
|
48
|
-
- `get_premium_market` — $0.05 USDC —
|
|
49
|
-
- `execute_paid_strategy` — $0.25 USDC —
|
|
47
|
+
- `get_premium_signals` — $0.02 USDC — **testnet only**; signals come from the autonomous loop, which runs on testnet. They reference testnet tokens, which have no monetary value, and are not a recommendation to buy, sell or hold anything. The mainnet box returns 501 without charging.
|
|
48
|
+
- `get_premium_market` — $0.05 USDC — market state with reference rates attributed to their source, fee pressure and network conditions. Factual data, no advice.
|
|
49
|
+
- `execute_paid_strategy` — $0.25 USDC — **testnet only**; execution needs a signing key and the mainnet box holds none by design, so it returns 501 without charging.
|
|
50
50
|
|
|
51
51
|
**Paid via MPP — requires a funded `STELLAR_SECRET_KEY`**
|
|
52
|
-
- `get_mpp_signals` — $0.02 USDC — same
|
|
52
|
+
- `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
53
|
- `get_mpp_market` — $0.05 USDC — same as `get_premium_market`, MPP-settled
|
|
54
54
|
|
|
55
55
|
## Environment variables
|
package/dist/index.js
CHANGED
|
@@ -201,11 +201,11 @@ server.tool('execute_demo', 'Dry-run a strategy via Soroban simulation — no re
|
|
|
201
201
|
// Cost: $0.02 USDC per signals call, $0.05 per market call, $0.25 per execution.
|
|
202
202
|
// Requires STELLAR_SECRET_KEY env var with funded testnet wallet.
|
|
203
203
|
//
|
|
204
|
-
server.tool('get_premium_signals', 'PAID ($0.02 USDC via x402) —
|
|
204
|
+
server.tool('get_premium_signals', 'PAID ($0.02 USDC via x402) — TESTNET ONLY: signals are produced by the autonomous loop, which runs on testnet; the mainnet box has no loop and returns 501 without charging. Signals reference testnet tokens, which have no monetary value, and are not a recommendation to buy, sell or hold anything. Requires funded Stellar wallet.', {
|
|
205
205
|
count: zod_1.z.number().optional().describe('Number of signals to fetch (default: 20, max: 100)'),
|
|
206
206
|
}, async (args) => paymentsUnavailable()
|
|
207
207
|
?? callJson(`${API_URL}/api/v1/premium/signals?count=${args.count || 20}`, undefined, paidFetch));
|
|
208
|
-
server.tool('get_premium_market', 'PAID ($0.05 USDC via x402) —
|
|
208
|
+
server.tool('get_premium_market', 'PAID ($0.05 USDC via x402) — Market state with reference rates attributed to their source, network fee pressure, and a description of current network conditions. Factual data only: no recommendation, no advice, no signal to act. Requires funded Stellar wallet.', {}, async () => paymentsUnavailable()
|
|
209
209
|
?? callJson(`${API_URL}/api/v1/premium/market`, undefined, paidFetch));
|
|
210
210
|
server.tool('execute_paid_strategy', 'PAID ($0.25 USDC via x402) — Execute a DeFi strategy on Stellar via Soroban. No Nirium account required — pay per execution. Requires funded Stellar wallet.', {
|
|
211
211
|
strategy: zod_1.z.string().describe('Strategy: flash-loan-arb | path-arbitrage | cross-dex | blend-yield | soroswap-swap'),
|
|
@@ -273,11 +273,11 @@ server.tool('get_reporting_summary', 'Institutional-format summary of settled pa
|
|
|
273
273
|
// Advantage over x402: no Coinbase facilitator dependency.
|
|
274
274
|
// Both x402 and MPP tools are available — client chooses.
|
|
275
275
|
//
|
|
276
|
-
server.tool('get_mpp_signals', 'PAID ($0.02 USDC via MPP Charge) —
|
|
276
|
+
server.tool('get_mpp_signals', 'PAID ($0.02 USDC via MPP Charge) — TESTNET ONLY, same data as get_premium_signals, settled via direct Soroban SAC transfer with no external facilitator. Testnet tokens have no monetary value; this is not a recommendation to buy, sell or hold anything. Requires funded Stellar wallet.', {
|
|
277
277
|
count: zod_1.z.number().optional().describe('Number of signals to fetch (default: 20, max: 100)'),
|
|
278
278
|
}, async (args) => paymentsUnavailable()
|
|
279
279
|
?? callJson(`${API_URL}/api/v1/mpp/signals?count=${args.count || 20}`, undefined, mppFetch));
|
|
280
|
-
server.tool('get_mpp_market', 'PAID ($0.05 USDC via MPP Charge) —
|
|
280
|
+
server.tool('get_mpp_market', 'PAID ($0.05 USDC via MPP Charge) — Market state settled via direct Soroban SAC transfer, no external facilitator. Reference rates with their source, fee pressure, and network conditions. Factual data only: no recommendation or advice. Requires funded Stellar wallet.', {}, async () => paymentsUnavailable()
|
|
281
281
|
?? callJson(`${API_URL}/api/v1/mpp/market`, undefined, mppFetch));
|
|
282
282
|
// ─── Start ────────────────────────────────────────────────────
|
|
283
283
|
async function main() {
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nirium-mcp",
|
|
3
|
-
"version": "0.5.
|
|
4
|
-
"description": "Model Context Protocol server for Nirium
|
|
3
|
+
"version": "0.5.1",
|
|
4
|
+
"description": "Model Context Protocol server for Nirium \u2014 exposes market data, autonomous loop control, and x402/MPP paid signals 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"
|