@oobe-protocol-labs/sap-mcp-server 0.9.35 → 0.9.36

package/skills/sap-operations/SKILL.md

@@ -36,12 +36,13 @@ Use `sap_discover_agents` for targeted hosted directory reads by `query`,
 `wallet`, `agentPda`, `protocol`, `capability`, `capabilities`, or
 `hasX402Endpoint`. Use `sap_list_all_agents` for global current ecosystem
 requests, keep pages small, and continue with `pagination.nextCursor`.
-For first-pass orientation, prefer free reads: `sap_agent_context`,
+For first-pass orientation, prefer free control-plane tools, then low-cost
+micro-read exact/base reads: `sap_agent_context`,
 `sap_get_agent`, `sap_get_agent_profile`, `sap_get_agent_stats`,
 `sap_is_agent_active`, `sap_get_global_state`, and `sap_list_agents` with `limit <= 20`,
-`view: "compact"`, and `includeProtocolIndexes: false`. Use paid discovery
-only when the user needs search, enrichment, full rows, large pages, analytics,
-or global enumeration beyond the compact page.
+`view: "compact"`, and `includeProtocolIndexes: false`. Use read-premium
+discovery only when the user needs search, enrichment, full rows, large pages,
+analytics, or global enumeration beyond the compact page.
 
 Before registering or updating an agent profile, call free
 `sap_protocol_invariants` when treasury, registration fee, hosted write route,

package/skills/sap-payments-x402/SKILL.md

@@ -45,18 +45,19 @@ the non-custodial model: OOBE does not hold user keys. Paid and value-moving
 hosted calls still proceed through x402/pay.sh plus the user's local SAP profile
 or external signer.
 
-- Free: `tools/list`, `prompts/list`, `resources/list`, `sap_profile_current`,
-  `sap_agent_start`, `sap_agent_runtime_status`, `sap_agent_context`,
+- Free: MCP handshake, `tools/list`, `prompts/list`, `resources/list`,
+  `sap_profile_current`, `sap_agent_start`, `sap_agent_runtime_status`,
   `sap_agent_next_action`, `sap_estimate_tool_cost`, `sap_pricing_catalog`,
-  exact SAP agent/profile reads, compact `sap_list_agents` pages with
-  `limit <= 20`, `sap_get_network_overview`, core balance checks
-  (`sol_get_balance`, `spl-token_getBalance`, `spl-token_getTokenAccounts`,
-  `spl-token_getMint`, `spl-token_getSupply`, `magicblock_balance`,
-  `sap_x402_get_balance`). Enriched holdings such as `jupiter_getHoldings`
-  are paid read-premium.
+  repair/status tools, local payment bridge control, transaction
+  preview/finalization helpers, SOL/SPL/x402 balance readiness, single-asset
+  price snapshots, and memory/audit helpers.
+- Micro read: exact SAP agent/profile reads, compact `sap_list_agents` pages
+  with `limit <= 20`, `sap_get_network_overview`, SNS availability, escrow
+  state, and lightweight trader/perps context.
 - Read premium: `sap_discover_agents`, `sap_list_all_agents`, full/enriched or
-  large `sap_list_agents` pages, indexed discovery, network stats,
-  protocol/capability indexes.
+  large `sap_list_agents` pages, enriched holdings, indexed discovery, network
+  stats, protocol/capability indexes, DAS, token lists, quotes/routes, and
+  OHLCV/history.
 - Builder: batch SNS/domain checks, analytics, transaction builders.
 - Value action: fixed fee plus configured basis-points fee when public USD
   notional fields are present.
@@ -98,12 +99,14 @@ For fast x402 execution:
    the local SAP MCP `sap_payments_call_paid_tool` bridge configured by the SAP
    MCP wizard instead of falling back to local stdio automatically.
 
-Do not use x402 for core balance reads. `sol_get_balance`,
-`spl-token_getBalance`, `spl-token_getTokenAccounts`, `magicblock_balance`,
-and `sap_x402_get_balance` are free hosted tools and should be called directly
-through the remote SAP MCP connection. Use `jupiter_getHoldings` only when the
-user needs enriched paid portfolio context. Always verify USDC and SOL balances
-before attempting paid calls — an agent without USDC cannot make paid calls.
+Do not use x402 for core balance or single-asset price readiness reads.
+`sol_get_balance`, `spl-token_getBalance`, `spl-token_getTokenAccounts`,
+`magicblock_balance`, `sap_x402_get_balance`, `jupiter_getPrice`,
+`pyth_getPrice`, and `coingecko_getTokenPrice` are free hosted tools and should
+be called directly through the remote SAP MCP connection. Use
+`jupiter_getHoldings` only when the user needs enriched paid portfolio context.
+Always verify USDC and SOL balances before attempting paid calls — an agent
+without USDC cannot make paid calls.
 
 Before any paid tool call, use `sap_estimate_tool_cost` with the tool name to
 get the exact tier, estimated USD cost, and recommended `maxPriceUsd`. This