@one-source/api-mcp 5.6.0 → 5.7.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.
Files changed (4) hide show
  1. package/README.md +2 -2
  2. package/README.npm.md +2 -2
  3. package/README.repo.md +2 -2
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -67,7 +67,7 @@ claude mcp add onesource-api -- npx onesource-api-mcp
67
67
  | Tool | Description |
68
68
  |------|-------------|
69
69
  | `1s_payment_mode` | View or switch the payment rail + mode: `x402-exact` / `x402-batch` (USDC on Base) or `mpp-charge` / `mpp-session` (Tempo) |
70
- | `1s_refund` | Refund unused x402 `batch` channel balance back to your wallet on demand |
70
+ | `1s_refund` | Reclaim an open payment channel's unspent deposit on demand — works for whichever rail's channel is active: x402 `batch` (Base) or MPP `session` (Tempo) |
71
71
 
72
72
 
73
73
  ## Networks
@@ -127,7 +127,7 @@ Set `MPP_PRIVATE_KEY` to a funded [Tempo](https://mpp.dev) wallet key. The serve
127
127
  MPP_PRIVATE_KEY=your-private-key-hex npx onesource-api-mcp
128
128
  ```
129
129
 
130
- MPP has two modes, switched with `1s_payment_mode`: **`mpp-charge`** (default — one payment per call) and **`mpp-session`** (a voucher channel — one on-chain deposit, capped by `MPP_MAX_DEPOSIT`, funds many off-chain calls; the unspent deposit is reclaimed automatically on clean shutdown). x402 and MPP are separate rails with separate wallets; if both keys are set, x402 is the initial rail and you switch between all four modes in-session.
130
+ MPP has two modes, switched with `1s_payment_mode`: **`mpp-charge`** (default — one payment per call) and **`mpp-session`** (a voucher channel — one on-chain deposit, capped by `MPP_MAX_DEPOSIT`, funds many off-chain calls; reclaim the unspent deposit any time with `1s_refund`, or it settles automatically on clean shutdown). x402 and MPP are separate rails with separate wallets; if both keys are set, x402 is the initial rail and you switch between all four modes in-session.
131
131
 
132
132
  ### No auth
133
133
 
package/README.npm.md CHANGED
@@ -67,7 +67,7 @@ claude mcp add onesource-api -- npx onesource-api-mcp
67
67
  | Tool | Description |
68
68
  |------|-------------|
69
69
  | `1s_payment_mode` | View or switch the payment rail + mode: `x402-exact` / `x402-batch` (USDC on Base) or `mpp-charge` / `mpp-session` (Tempo) |
70
- | `1s_refund` | Refund unused x402 `batch` channel balance back to your wallet on demand |
70
+ | `1s_refund` | Reclaim an open payment channel's unspent deposit on demand — works for whichever rail's channel is active: x402 `batch` (Base) or MPP `session` (Tempo) |
71
71
 
72
72
 
73
73
  ## Networks
@@ -127,7 +127,7 @@ Set `MPP_PRIVATE_KEY` to a funded [Tempo](https://mpp.dev) wallet key. The serve
127
127
  MPP_PRIVATE_KEY=your-private-key-hex npx onesource-api-mcp
128
128
  ```
129
129
 
130
- MPP has two modes, switched with `1s_payment_mode`: **`mpp-charge`** (default — one payment per call) and **`mpp-session`** (a voucher channel — one on-chain deposit, capped by `MPP_MAX_DEPOSIT`, funds many off-chain calls; the unspent deposit is reclaimed automatically on clean shutdown). x402 and MPP are separate rails with separate wallets; if both keys are set, x402 is the initial rail and you switch between all four modes in-session.
130
+ MPP has two modes, switched with `1s_payment_mode`: **`mpp-charge`** (default — one payment per call) and **`mpp-session`** (a voucher channel — one on-chain deposit, capped by `MPP_MAX_DEPOSIT`, funds many off-chain calls; reclaim the unspent deposit any time with `1s_refund`, or it settles automatically on clean shutdown). x402 and MPP are separate rails with separate wallets; if both keys are set, x402 is the initial rail and you switch between all four modes in-session.
131
131
 
132
132
  ### No auth
133
133
 
package/README.repo.md CHANGED
@@ -67,7 +67,7 @@ claude mcp add onesource-api -- npx onesource-api-mcp
67
67
  | Tool | Description |
68
68
  |------|-------------|
69
69
  | `1s_payment_mode` | View or switch the payment rail + mode: `x402-exact` / `x402-batch` (USDC on Base) or `mpp-charge` / `mpp-session` (Tempo) |
70
- | `1s_refund` | Refund unused x402 `batch` channel balance back to your wallet on demand |
70
+ | `1s_refund` | Reclaim an open payment channel's unspent deposit on demand — works for whichever rail's channel is active: x402 `batch` (Base) or MPP `session` (Tempo) |
71
71
 
72
72
 
73
73
  ## Networks
@@ -130,7 +130,7 @@ MPP_PRIVATE_KEY=your-private-key-hex npx onesource-api-mcp
130
130
  MPP has two modes, switched with `1s_payment_mode`:
131
131
 
132
132
  - **`mpp-charge`** (default) — one signed Tempo payment per call.
133
- - **`mpp-session`** — a voucher channel: the first call opens an on-chain channel (capped by `MPP_MAX_DEPOSIT`, default `1`), then subsequent calls are signed off-chain as cumulative vouchers. The unspent deposit is settled and reclaimed automatically when the server shuts down cleanly. A hard kill leaves it locked until reclaimed on-chain later.
133
+ - **`mpp-session`** — a voucher channel: the first call opens an on-chain channel (capped by `MPP_MAX_DEPOSIT`, default `1`), then subsequent calls are signed off-chain as cumulative vouchers. Reclaim the unspent deposit any time with the `1s_refund` tool; it is also settled and reclaimed automatically when the server shuts down cleanly. A hard kill before either leaves it locked until reclaimed on-chain later.
134
134
 
135
135
  x402 and MPP are separate rails with separate wallets (USDC on Base vs USDC.e/pathUSD on Tempo). If both `X402_PRIVATE_KEY` and `MPP_PRIVATE_KEY` are set, x402 is the initial rail; switch between all four modes in-session with `1s_payment_mode`.
136
136
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@one-source/api-mcp",
3
- "version": "5.6.0",
3
+ "version": "5.7.1",
4
4
  "type": "module",
5
5
  "description": "MCP server for OneSource blockchain data — named tools for balances, NFTs, transactions, events, live chain queries, with x402 (USDC on Base) and MPP (Tempo) pay-per-call payment rails",
6
6
  "bin": {