@gblin-protocol/mcp-server 0.5.2 → 0.6.0

package/README.md

@@ -50,6 +50,25 @@ Fees: 0.10% on every mint with ETH or WETH (0.05% stays in the vault and lifts t
 
 A stateless Streamable HTTP server runs at `https://gblin-mcp.gblin-mcp-worker.workers.dev/mcp` — no install, no auth, no session, 60 requests per minute per IP. It serves the vault, action and payment tools of this package under two-level names (`treasury.*`, `actions.*`, `payments.*`, `governance.state`, `auction.state`, `attestation.verify`), built from the same source, plus the risk, receipts and coherence tools; the snake_case names below are accepted there as aliases. GET-only audit surfaces: [`/meta`](https://gblin-mcp.gblin-mcp-worker.workers.dev/meta), [`/tools.json`](https://gblin-mcp.gblin-mcp-worker.workers.dev/tools.json), [`/resources.json`](https://gblin-mcp.gblin-mcp-worker.workers.dev/resources.json), [`/conformance`](https://gblin-mcp.gblin-mcp-worker.workers.dev/conformance). Also listed on [Smithery](https://smithery.ai/servers/gblin-protocol/mcp).
 
+## Agent treasury (library and CLI)
+
+`packages/agent-treasury` — npm `@gblin-protocol/agent-treasury`. Operating cash stays in USDC, the surplus above a
+reserve is parked in GBLIN, and USDC is pulled back from GBLIN just in time when an x402 invoice arrives. The x402 client is
+Coinbase's reference `x402Client` with the refill attached to its `onBeforePaymentCreation` hook, so a 402 for USDC on Base
+triggers the refill before the authorization is signed and a price above the cap is refused before anything is signed.
+Self-custody, no key leaves the process. Verified end to end on a fork of Base (24 checks: park, refill, cooldown, a
+mock invoice with the challenge bytes of gblin.digital and a verified EIP-712 signature, the cap).
+
+```bash
+export GBLIN_AGENT_PRIVATE_KEY=0x...
+npx @gblin-protocol/agent-treasury status --json
+npx @gblin-protocol/agent-treasury park --json
+npx @gblin-protocol/agent-treasury pay https://gblin.digital/api/x402/attestation --max-amount 3000 --json
+```
+
+The matching agent skill is `skills/gblin-agent-treasury` (`npx skills add gblinproject/gblin-treasury-risk-regime`).
+Details: [packages/agent-treasury/README.md](packages/agent-treasury/README.md).
+
 ## API
 
 ### Tools
@@ -89,6 +108,16 @@ A stateless Streamable HTTP server runs at `https://gblin-mcp.gblin-mcp-worker.w
     - `wallet_address` (string)
     - `daily_burn_usd` (number, optional): average daily spend, enables the runway estimate
 
+- **plan_treasury**
+  - Idle USDC to a reviewable plan in one call: the operating cash to keep liquid (`max(reserve_usd, daily_burn_usd × days)`), the surplus above it, a simulation of minting that surplus at NAV with every fee read live and the estimated value of exiting the same position today (round-trip cost included), the same simulation for a trial amount, the blockers (crash shield, cooldown, ETH for the exit) and the tools to call after a human confirms. Reads only; nothing is executed and nothing is advised
+  - Inputs:
+    - `wallet_address` (string)
+    - `daily_burn_usd` (number, optional): average daily spend in USD
+    - `days` (number, optional): days of spend to keep liquid, default 7
+    - `reserve_usd` (number, optional): USD to keep liquid regardless of the burn rate; one of `daily_burn_usd` or `reserve_usd` is required
+    - `trial_usdc` (number, optional): trial amount to simulate beside the surplus, default 100
+  - The same plan is served over HTTP at `https://gblin.digital/api/x402/plan`
+
 - **get_governance_state**
   - Owner and pending owner of the vault, the fee recipient, the timelock's minimum delay and roles, and, when the pending owner is the timelock, the deterministic id and state of the scheduled `acceptOwnership` operation
   - Inputs:
@@ -289,12 +318,12 @@ Pay-per-call data lives on HTTP, settled in USDC on Base through the Coinbase CD
 
 | Endpoint | Price | Returns |
 |---|---|---|
-| `GET gblin.digital/api/x402/treasury-state` | $0.001 | NAV, basket weights, Crash Shield status |
-| `GET gblin.digital/api/x402/quote` | $0.001 | Mint or redemption preview with the dynamic slippage buffer |
-| `GET gblin.digital/api/x402/governance` | $0.001 | Owner, timelock, pending operations |
-| `GET gblin.digital/api/x402/health` | $0.002 | Wallet balances, gas runway, allocation advice |
-| `GET gblin.digital/api/x402/invest` | $0.002 | Unsigned calldata: USDC → GBLIN |
-| `GET gblin.digital/api/x402/jit` | $0.005 | Unsigned calldata: GBLIN → USDC just in time |
+| `GET gblin.digital/api/x402/treasury-state` | free | NAV, basket weights, Crash Shield status |
+| `GET gblin.digital/api/x402/quote` | free | Mint or redemption preview with the dynamic slippage buffer |
+| `GET gblin.digital/api/x402/governance` | free | Owner, timelock, pending operations |
+| `GET gblin.digital/api/x402/health` | free | Wallet balances, gas runway, allocation advice |
+| `GET gblin.digital/api/x402/invest` | free | Unsigned calldata: USDC → GBLIN |
+| `GET gblin.digital/api/x402/jit` | free | Unsigned calldata: GBLIN → USDC just in time |
 | `GET gblin.digital/api/x402/attestation` | $0.003 | Signed EIP-712 Risk Attestation, valid ten minutes |
 | `POST gblin.digital/api/x402/seal` | $0.0045 | A sealed AI Action Receipt |