LIVE
Nirium← Home
SDK + API + MCP

Build on
Nirium

B2B Infrastructure: TypeScript SDK, 65+ REST endpoints, MCP server for Claude/Cursor, and native support for x402 + MPP micropayments.

bash
npm install nirium
Non-Custodial
Institutional Grade
SCF KICKSTART
COC COMPLIANT

Regulatory Disclosure: B2B Software Provider

Nirium is strictly a software and infrastructure provider (SDK/API). We do not operate as a Financial Technology Institution (ITF), do not manage third-party funds, and are not subject to registration under Art. 80 of the Fintech Law. All operational, KYC, AML, and compliance responsibilities fall entirely on the regulated institutional operator utilizing our infrastructure. Nirium acts solely as a decentralized routing layer on Soroban.

Provisioning: 5 Lines

Autonomous corporate rebalancing (USDC to CETES) in production.

typescript
import { NiriumAgent } from "nirium"; const agent = new NiriumAgent({ apiKey: process.env.NIRIUM_API_KEY }); // Rebalance: keep 60% in CETES (gov. rate), 40% USDC (liquid) await agent.rebalance({ cetes: 60, usdc: 40 }); // Send cross-border: USD → MXN receiver gets USDC instantly await agent.transfer({ to: "G...", amount: 1000, asset: "USDC" });

B2B Micropayments for Agents

x402 for API-level atomic payments. MPP Charge for per-request settlement without an external facilitator.

x402 — Atomic Per-call Payment

Linux Foundation Standard

typescript
import { NiriumAgent } from "nirium"; const agent = new NiriumAgent({ apiKey: process.env.NIRIUM_API_KEY }); // x402: per-call payment — agent pays $0.05 per API call automatically const result = await agent.callPaidEndpoint({ url: "https://api.example.com/data", maxFee: "0.05", // USD, reject if server asks more asset: "USDC", });
No CustodianAtomic On-chain

MPP — Corporate Settlement

Stripe/Tempo Spec

typescript
import { NiriumAgent } from "nirium"; const agent = new NiriumAgent({ apiKey: process.env.NIRIUM_API_KEY }); // MPP Charge: your client signs a USDC transfer inside each request. // No facilitator, no deposit — settled on-chain before the response. agent.initMpp({ secretKey: process.env.STELLAR_SECRET_KEY, // signs the transfer network: "stellar:pubnet", mode: "pull", }); const signals = await agent.mppFetch("/api/v1/mpp/signals"); // $0.02 const market = await agent.mppFetch("/api/v1/mpp/market"); // $0.05
Balance ReturnedIdeal for Agents
Featurex402MPP ChargeMPP Channel
On-chain tx per call
Requires SaaS facilitator
Institution needs XLMOpt.
Optimized forRapid IntegrationNative B2B P2PHigh-Freq Settlement

The table compares the three protocols. Nirium runs x402 and MPP Charge today, on testnet and mainnet. MPP Channel requires a funded on-chain channel contract, so it stays behind the same external-audit gate as the treasury vault — the endpoints exist and report channel mode as disabled.

Console Integration (MCP)

MCP Server
Claude & Cursor

Connect your Claude Desktop or Cursor instance to your infrastructure in 2 minutes. Enable your node to manage corporate capital securely and auditably.

json
// Claude Desktop config (~/.claude/claude_desktop_config.json) { "mcpServers": { "nirium": { "command": "npx", "args": ["-y", "nirium-mcp"], "env": { "NIRIUM_API_KEY": "your_key_here" } } } }

11 Base Operations

get_market_state

Get live tickers: XLM/USDC price, base fee, Blend APY

get_loop_status

Check autonomous loop status, scan count, and uptime

start_loop

Start the autonomous market scanning loop (Auth)

stop_loop

Stop the autonomous market scanning loop (Auth)

execute_demo

Simulate a strategy via Soroban dry-run (Free)

get_premium_signals

Get premium arbitrage signals via x402 ($0.02 USDC)

get_premium_market

Get enriched market state via x402 ($0.05 USDC)

execute_paid_strategy

Execute strategy on-chain via x402 ($0.25 USDC)

+ 3 MORE TOOLS IN DOCUMENTATION
Live Protocol Surface v0.7.0

Telemetry Hub

65+ Endpoints architected strictly for institutional autonomous routing and forensic export (Fintech Law).

Core B2B Infrastructure

POST
Live
/v1/agent/rebalance

Trigger USDC↔CETES rebalance

POST
Live
/v1/agent/transfer

Cross-border USDC transfer

GET
Live
/v1/vault/status

Get vault balances + rates

POST
Live
/v1/vault/create

Deploy new 2-of-3 Soroban vault

POST
Live
/v1/vault/pause

Emergency pause (2-of-3 required)

POST
Live
/v1/vault/withdraw

Withdraw >$10K (2-of-3 required)

POST
Live
/v1/x402/challenge

Create x402 payment challenge

POST
Live
/v1/x402/verify

Verify x402 payment proof

Compliance Explorer

Auth & Security

POST/api/auth/token
CORE
POST/api/auth/keys
CORE
GET/api/health
LIVE
POST/api/authenticate
LIVE

Treasury Engine

POST/api/loop/start
PREMIUM
POST/api/loop/stop
CORE
POST/api/execute
PREMIUM
GET/api/loop/status
LIVE

Compliance & IPFS

POST/v1/compliance/audit
PRO
POST/v1/compliance/ipfs
PRO
POST/v1/compliance/export
PRO
GET/v1/compliance/verify/:cid
LIVE

Market Intelligence

GET/api/market
LIVE
GET/api/tickers
LIVE
GET/api/strategies
LIVE
GET/api/signals/recent
PREMIUM

Disbursement & Nodes

GET/api/nodes
LIVE
POST/api/payroll/run
CORE
POST/api/payroll/submit
CORE
POST/api/payroll/onboard
CORE
+4
+8
+12
+16

+18 Modular subsystems for Institutional Orchestration

Soroban Mainnet Readiness

Hardened Execution Nodes

Non-custodial Soroban smart contracts deployed on Stellar Testnet.

NiriumVaultCore treasury: vaults, agent delegation, strategy execution, 2-of-3 multisig
CBTWMZCG3P72EHFAQ4ZLSEBIOFYJC244H5J6DHZIJ56FHFWJ2CFAWSZU
NiriumProtocolUnified registry: ELO reputation, strategy marketplace, agent scoring, skill gate
CC2TU5BDTKTPRRRQPEF77I54XYHFQ25XGIRO2TCWKSR7NRJDFR5L5NR5
CETES (Mexican Bonds)Government Bond Asset (Etherfuse)
CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC
USDC (Stellar Testnet SAC)Primary liquidity asset
CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA

Infrastructure Requirements?

Get access to the provisioning endpoints in Sandbox.