@oobe-protocol-labs/sap-mcp-server 0.9.51 → 0.9.52

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobe-protocol-labs/sap-mcp-server",
-  "version": "0.9.51",
+  "version": "0.9.52",
   "mcpName": "ai.oobeprotocol.sap.mcp/sap-mcp",
   "description": "Official MCP gateway for OOBE Protocol SAP — AI agents can interact with SAP identity, registry, reputation, tools, memory, payments, settlement, and proof-of-execution on Solana",
   "type": "module",

package/server.json

@@ -3,7 +3,7 @@
   "name": "ai.oobeprotocol.sap.mcp/sap-mcp",
   "title": "SAP MCP Server | OOBE Protocol",
   "description": "Solana-native MCP gateway for SAP tools, DeFi, SNS identity, x402/pay.sh, and agent operations.",
-  "version": "0.9.51",
+  "version": "0.9.52",
   "websiteUrl": "https://mcp.sap.oobeprotocol.ai/",
   "repository": {
     "url": "https://github.com/OOBE-PROTOCOL/sap-mcp",
@@ -29,7 +29,7 @@
     {
       "registryType": "npm",
       "identifier": "@oobe-protocol-labs/sap-mcp-server",
-      "version": "0.9.51",
+      "version": "0.9.52",
       "transport": {
         "type": "stdio"
       },
@@ -45,7 +45,7 @@
         },
         {
           "type": "positional",
-          "value": "@oobe-protocol-labs/sap-mcp-server@0.9.51"
+          "value": "@oobe-protocol-labs/sap-mcp-server@0.9.52"
         },
         {
           "type": "positional",

package/skills/sap-defi/SKILL.md

@@ -46,7 +46,7 @@ bridges, and staking protocols.
 
 ## Adrena Perps Protocol (32 tools)
 
-SAP MCP 0.9.38+ includes a full native Adrena integration: local unsigned
+SAP MCP 0.9.51+ includes a full native Adrena integration: local unsigned
 transaction builders for every Adrena operation plus a REST Data API client.
 All builders use the vendored official Adrena IDL (release/39) via
 `@coral-xyz/anchor` and produce unsigned base64 transactions for local
@@ -54,12 +54,13 @@ signing via `sap_payments_finalize_transaction`.
 
 ### Trading Builders
 
-- `sap_adrena_build_open_long` — Open/increase a long perp position
-- `sap_adrena_build_open_short` — Open/increase a short perp position
+- `sap_adrena_build_open_long` — Open/increase a long perp position. Optional `stopLossPriceUsd` for policy compliance
+- `sap_adrena_build_open_short` — Open/increase a short perp position. Optional `stopLossPriceUsd` for policy compliance
+- `sap_adrena_build_position_package` — Open + set SL + set TP atomically in one transaction (1 payment, 1 signing, 1 submit). Preferred over separate open + SL + TP calls
 - `sap_adrena_build_close_long` — Close a long perp position
 - `sap_adrena_build_close_short` — Close a short perp position
-- `sap_adrena_build_set_stop_loss` — Set stop loss on a position
-- `sap_adrena_build_set_take_profit` — Set take profit on a position
+- `sap_adrena_build_set_stop_loss` — Set stop loss on an existing position
+- `sap_adrena_build_set_take_profit` — Set take profit on an existing position
 - `sap_adrena_build_cancel_stop_loss` — Cancel stop loss
 - `sap_adrena_build_cancel_take_profit` — Cancel take profit
 - `sap_adrena_build_add_limit_order` — Place a limit order
@@ -97,7 +98,7 @@ signing via `sap_payments_finalize_transaction`.
 - `sap_adrena_get_mutagen_leaderboard` — Mutagen leaderboard
 - `sap_adrena_get_prices` — ADX and ALP token prices
 - `sap_adrena_get_trading_prices` — Latest oracle prices for all assets
-- `sap_adrena_get_position_status` — Live position P&L
+- `sap_adrena_get_position_status` — Live position P&L from Adrena Data API. If the Data API is unavailable, fall back to `sap_perp_position_info` which reads the on-chain Position account directly via Solana RPC
 
 ## Flow
 
@@ -130,21 +131,48 @@ planning tools before any value-moving action:
    `sap_chart_volume_profile` for trend, timeframe, and liquidity context.
 5. Call `sap_perp_liquidation_zones` to understand liquidation distance.
 6. Call `sap_perp_trade_plan` with market, side, collateral amount, leverage,
-   entry price, stop loss, take profit, max slippage, and max account-risk
-   policy.
+   entry price (required, fetch from `sap_adrena_get_trading_prices` first),
+   stop loss, take profit, max slippage, and max account-risk policy.
 7. Call `sap_perp_builder_status` to confirm which Adrena operations are
-   available. As of 0.9.38, all 22 builder operations and 10 Data API tools
+   available. As of 0.9.51, all builder operations and Data API tools
    are available natively.
 
 ### Execution Flow (Adrena)
 
+**Preferred: atomic batch (1 payment, 1 signing, 1 submit)**
+
+1. Call `sap_adrena_build_position_package` with the owner wallet,
+   principal token, collateral token, amount, leverage, side, and
+   optional `stopLossPriceUsd` / `takeProfitPriceUsd`. This builds a
+   single unsigned transaction with 3 atomic instructions:
+   openOrIncreasePosition + setStopLoss + setTakeProfit.
+2. Call `sap_payments_finalize_transaction` with `transactionBase64` and
+   `submit: true` (after user confirmation) to sign and submit locally.
+3. If the position opens but SL/TP instructions fail, the position is
+   unprotected. The atomic batch prevents this: all 3 instructions land
+   in the same transaction or none do.
+
+**Alternative: separate calls (3 payments, 3 signings)**
+
 1. Call `sap_adrena_build_open_long` (or short) with the owner wallet,
-   principal token, collateral token, amount, and leverage.
+   principal token, collateral token, amount, leverage, and optional
+   `stopLossPriceUsd` for policy compliance.
 2. The builder returns `transactionBase64` — an unsigned Solana transaction
    constructed from the vendored Adrena IDL via `@coral-xyz/anchor`.
 3. Call `sap_payments_finalize_transaction` with `transactionBase64` and
    `submit: true` (after user confirmation) to sign and submit locally.
-4. SAP MCP never signs user-owned Adrena transactions. All signing is local.
+4. After the position is confirmed on-chain, call `sap_adrena_build_set_stop_loss`
+   and `sap_adrena_build_set_take_profit` separately.
+5. SAP MCP never signs user-owned Adrena transactions. All signing is local.
+
+### Policy: stop_loss_required
+
+The SAP MCP policy engine has a `stopLossRequired` flag (default: false
+as of 0.9.51). When enabled in the profile config, `sap_adrena_build_open_long`
+and `sap_adrena_build_open_short` require `stopLossPriceUsd` to be set.
+If omitted, the builder returns `PolicyViolation: stop_loss_required`.
+Pass `stopLossPriceUsd` or use `sap_adrena_build_position_package` which
+accepts it directly.
 
 ### Collateral Rules
 

package/skills/sap-mcp/TOOL_REFERENCE.md

@@ -220,14 +220,15 @@ Social, Blinks, bounties, gaming:
 `gibwork_createBounty`, `gibwork_listBounties`, `gibwork_submitWork`,
 `send-arcade_listGames`, `send-arcade_playGame`.
 
-Perps note: SAP MCP 0.9.38+ includes a full native Adrena integration with
-32 tools. All 22 builder operations construct unsigned Solana transactions
+Perps note: SAP MCP 0.9.51+ includes a full native Adrena integration with
+32 tools. All builder operations construct unsigned Solana transactions
 locally using the vendored Adrena Anchor IDL (release/39) via
 `@coral-xyz/anchor`, then return `transactionBase64` for local signing via
 `sap_payments_finalize_transaction`. No external builder URL is required.
 
 Adrena trading builders: `sap_adrena_build_open_long`,
-`sap_adrena_build_open_short`, `sap_adrena_build_close_long`,
+`sap_adrena_build_open_short`, `sap_adrena_build_position_package` (atomic
+open + SL + TP in 1 transaction), `sap_adrena_build_close_long`,
 `sap_adrena_build_close_short`, `sap_adrena_build_set_stop_loss`,
 `sap_adrena_build_set_take_profit`, `sap_adrena_build_cancel_stop_loss`,
 `sap_adrena_build_cancel_take_profit`, `sap_adrena_build_add_limit_order`,