@oobe-protocol-labs/sap-mcp-server 0.9.37 → 0.9.50

package/docs/BRANCH_AND_CI.md

@@ -5,7 +5,7 @@
 ```
 main          ← production-ready, tagged releases only
 develop       ← integration branch, PRs merge here first
-release/*     ← optional release prep branches (release/0.9.37)
+release/*     ← optional release prep branches (release/0.9.38)
 feature/*     ← short-lived feature branches → PR to develop
 hotfix/*      ← urgent fixes → PR to main + cherry-pick to develop
 ```
@@ -57,7 +57,7 @@ GitHub Actions secrets (configured in repo settings):
 
 ## Tag convention
 
-Tags are plain version numbers: `0.9.37` (NOT `v0.9.37`).
+Tags are plain version numbers: `0.9.38` (NOT `v0.9.38`).
 
 ## Binary artifacts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobe-protocol-labs/sap-mcp-server",
-  "version": "0.9.37",
+  "version": "0.9.50",
   "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",
@@ -91,6 +91,7 @@
     "@oobe-protocol-labs/synapse-client-sdk": "^2.0.6",
     "@oobe-protocol-labs/synapse-sap-sdk": "^1.0.2",
     "@solana/kit": "^5.5.1",
+    "@solana/spl-token": "0.3.8",
     "@solana/sysvars": "^5.5.1",
     "@solana/web3.js": "^1.95.0",
     "@types/better-sqlite3": "^7.6.13",
@@ -158,4 +159,4 @@
     "ws": "^8.21.0"
   },
   "packageManager": "pnpm@11.7.0"
-}
+}

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.37",
+  "version": "0.9.50",
   "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.37",
+      "version": "0.9.50",
       "transport": {
         "type": "stdio"
       },
@@ -45,7 +45,7 @@
         },
         {
           "type": "positional",
-          "value": "@oobe-protocol-labs/sap-mcp-server@0.9.37"
+          "value": "@oobe-protocol-labs/sap-mcp-server@0.9.50"
         },
         {
           "type": "positional",

package/skills/sap-defi/SKILL.md

@@ -29,6 +29,7 @@ bridges, and staking protocols.
 - `sap_perp_position_info`
 - `sap_perp_funding_history`
 - `sap_perp_liquidation_zones`
+- `sap_perp_builder_status`
 - `sap_chart_ohlc`
 - `sap_chart_long_term`
 - `sap_chart_volume_profile`
@@ -43,6 +44,61 @@ bridges, and staking protocols.
 - `bridging_*`
 - `staking_*`
 
+## Adrena Perps Protocol (32 tools)
+
+SAP MCP 0.9.38+ 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
+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_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_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
+- `sap_adrena_build_cancel_limit_order` — Cancel a limit order
+
+### Commodity Builders (synthetic perps: XAU, XAG, WTI)
+
+- `sap_adrena_build_open_commodity_long`
+- `sap_adrena_build_open_commodity_short`
+- `sap_adrena_build_close_commodity_long`
+- `sap_adrena_build_close_commodity_short`
+
+### Liquidity & Swap
+
+- `sap_adrena_build_add_liquidity` — Add liquidity to a pool
+- `sap_adrena_build_remove_liquidity` — Remove liquidity from a pool
+- `sap_adrena_build_swap` — Swap tokens through a pool
+
+### Staking
+
+- `sap_adrena_build_init_user_staking` — Initialize user staking account
+- `sap_adrena_build_add_liquid_stake` — Add liquid stake
+- `sap_adrena_build_remove_liquid_stake` — Remove liquid stake
+- `sap_adrena_build_add_locked_stake` — Add locked stake
+- `sap_adrena_build_claim_stakes` — Claim staking rewards
+
+### Data API (market data from datapi.adrena.trade)
+
+- `sap_adrena_get_positions` — Position history for a wallet
+- `sap_adrena_get_pool_info` — Latest pool statistics
+- `sap_adrena_get_custody_info` — Per-asset custody statistics
+- `sap_adrena_get_trader_info` — Trader performance metrics
+- `sap_adrena_get_trader_leaderboard` — Trader leaderboard
+- `sap_adrena_get_mutagen` — Mutagen points for a wallet
+- `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
+
 ## Flow
 
 1. Use quote/read tools first.
@@ -60,34 +116,49 @@ bridges, and staking protocols.
 
 ## Professional Perps Flow
 
-For perps or leveraged trading tasks, start with hosted SAP analytics and
+For perps or leveraged trading tasks, start with Adrena market data and
 planning tools before any value-moving action:
 
-1. Call `sap_perp_markets` to inspect supported markets, mark prices, funding,
-   and open interest.
-2. Call `sap_perp_position_info` when the user has an existing wallet position.
-3. Call `sap_chart_ohlc`, `sap_chart_long_term`, or
+1. Call `sap_adrena_get_pool_info` or `sap_perp_markets` to inspect Adrena
+   markets: supported custody, pool, oracle labels, funding state, leverage
+   caps, open interest, and cumulative volume.
+2. Call `sap_adrena_get_trading_prices` for live oracle prices across all
+   traded assets (JITOSOL, WBTC, BONK, XAU, XAG, WTI).
+3. Call `sap_adrena_get_positions` or `sap_perp_position_info` when the user
+   has an existing wallet position.
+4. Call `sap_chart_ohlc`, `sap_chart_long_term`, or
    `sap_chart_volume_profile` for trend, timeframe, and liquidity context.
-4. Call `sap_perp_liquidation_zones` to understand liquidation distance and
-   crowded-risk areas.
-5. Call `sap_perp_trade_plan` with market, side, collateral amount, leverage,
+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.
+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
+   are available natively.
+
+### Execution Flow (Adrena)
+
+1. Call `sap_adrena_build_open_long` (or short) with the owner wallet,
+   principal token, collateral token, amount, and leverage.
+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.
+
+### Collateral Rules
+
+- **Longs**: collateral token must match principal token (e.g. a JITOSOL
+  long requires JITOSOL collateral).
+- **Shorts**: collateral must be USDC.
+- **Commodities** (XAU, XAG, WTI): collateral is always USDC.
+
+### Supported Assets
 
-`sap_perp_trade_plan` is analysis-only. It returns trader-grade risk flags,
-liquidation estimate, reward/risk, and an execution checklist. `sap_perp_markets`
-may return `dataAvailability.status="unavailable"` when the configured RPC does
-not serve the required perps account indexes; treat that as missing data, not as
-proof that markets do not exist. Do not create temporary signing scripts, do not
-guess perps account graphs, and do not execute a perps transaction unless SAP MCP
-exposes a typed unsigned builder or a local SAP payments/signing tool for that
-exact action.
-
-Direct Adrena signer tools may exist in some local AgentKit builds, but hosted
-SAP MCP blocks them before x402 payment because the hosted server is
-accountless. Do not route `adrena_openPosition`, `adrena_closePosition`, or
-collateral-changing Adrena calls through `sap_payments_call_paid_tool`; there is
-no payment challenge and no unsigned transaction to finalize.
+| Pool | Assets | Collateral |
+|------|--------|------------|
+| main-pool | JITOSOL, WBTC, BONK | USDC, JITOSOL, WBTC, BONK |
+| commodities-pool | XAU (Gold), XAG (Silver), WTI (Crude Oil) | USDC |
 
 ## Safety
 

package/skills/sap-mcp/TOOL_REFERENCE.md

@@ -220,7 +220,42 @@ Social, Blinks, bounties, gaming:
 `gibwork_createBounty`, `gibwork_listBounties`, `gibwork_submitWork`,
 `send-arcade_listGames`, `send-arcade_playGame`.
 
-Perps note: SAP MCP hosted supports perps analytics and trader-grade planning,
-not direct hosted Adrena execution. If direct Adrena signer tools are visible in
-a local runtime, use them only with that local runtime's signer path and policy.
-Do not route direct Adrena writes through hosted x402 paid-call replay.
+Perps note: SAP MCP 0.9.38+ includes a full native Adrena integration with
+32 tools. All 22 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_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`,
+`sap_adrena_build_cancel_limit_order`.
+
+Commodity builders (XAU, XAG, WTI): `sap_adrena_build_open_commodity_long`,
+`sap_adrena_build_open_commodity_short`, `sap_adrena_build_close_commodity_long`,
+`sap_adrena_build_close_commodity_short`.
+
+Liquidity & swap: `sap_adrena_build_add_liquidity`,
+`sap_adrena_build_remove_liquidity`, `sap_adrena_build_swap`.
+
+Staking: `sap_adrena_build_init_user_staking`, `sap_adrena_build_add_liquid_stake`,
+`sap_adrena_build_remove_liquid_stake`, `sap_adrena_build_add_locked_stake`,
+`sap_adrena_build_claim_stakes`.
+
+Data API (datapi.adrena.trade): `sap_adrena_get_positions`,
+`sap_adrena_get_pool_info`, `sap_adrena_get_custody_info`,
+`sap_adrena_get_trader_info`, `sap_adrena_get_trader_leaderboard`,
+`sap_adrena_get_mutagen`, `sap_adrena_get_mutagen_leaderboard`,
+`sap_adrena_get_prices`, `sap_adrena_get_trading_prices`,
+`sap_adrena_get_position_status`.
+
+Legacy perps analytics remain available: `sap_perp_markets`,
+`sap_perp_position_info`, `sap_perp_funding_history`,
+`sap_perp_liquidation_zones`, `sap_perp_trade_plan`, `sap_perp_builder_status`,
+`sap_chart_ohlc`, `sap_chart_long_term`, `sap_chart_volume_profile`.
+
+Collateral rules: longs require collateral = principal token; shorts require
+USDC collateral; commodities always use USDC. Supported main-pool assets:
+JITOSOL, WBTC, BONK. Supported commodities: XAU, XAG, WTI.