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 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 signals 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/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 — arbitrage signals with execution paths and confidence scores
48
- - `get_premium_market` — $0.05 USDC — enriched market state
49
- - `execute_paid_strategy` — $0.25 USDC — execute a strategy on-chain, no account required
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 signal data as `get_premium_signals`, settled via direct Soroban SAC transfer, no external facilitator
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) — Premium arbitrage signals with execution paths, confidence scores, profit estimates, and valid-until ledger windows. Requires funded Stellar wallet.', {
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) — Enriched market state: arbitrage windows, yield ranking, fee pressure alerts, and execution recommendation. Requires funded Stellar wallet.', {}, async () => paymentsUnavailable()
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) — Premium arbitrage signals settled via direct Soroban SAC transfer. No external facilitator. Same signal data as get_premium_signals. Requires funded Stellar wallet.', {
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) — Enriched market state settled via direct Soroban SAC transfer. No external facilitator. Includes arbitrage windows, yield ranking, and fee alerts. Requires funded Stellar wallet.', {}, async () => paymentsUnavailable()
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.0",
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.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"