@oobe-protocol-labs/sap-mcp-server 0.9.1 → 0.9.3

package/skills/sap-sns/SKILL.md

@@ -9,15 +9,21 @@ This skill is adapted from upstream `sns-skill` plus SAP MCP's
 ## Safe Flow
 
 1. Check the loaded profile with `sap_profile_current`.
-2. Check domain availability with `sap_sns_check_domain`.
+2. Check one domain availability for free with `sap_sns_check_domain`.
 3. Validate records with `sap_sns_validate_records`.
-4. Build unsigned transactions when possible:
-   - `sap_sns_build_register_domain_transaction`
-   - `sap_sns_build_manage_record_transaction`
-   - `sap_sns_build_set_primary_domain_transaction`
-5. Preview transaction with `sap_preview_transaction`.
-6. Sign only through `sap_sign_transaction` or the direct tool
-   `sap_sns_register_agent_domain` when policy allows it.
+4. For hosted record updates, build an unsigned transaction with
+   `sap_sns_build_manage_record_transaction`.
+5. Preview and finalize hosted builder transactions locally with
+   `sap_payments_finalize_transaction`.
+6. Register domains directly only from a local SAP MCP profile using
+   `sap_sns_register_agent_domain` after explicit user confirmation.
+7. After SNS ownership or records are ready, update the SAP agent metadata with
+   `sap_payments_update_agent` so `metadataUri` references the `.sol` identity.
+
+Hosted accountless SAP MCP cannot register a .sol domain directly because the
+purchase requires the user wallet signature. If a hosted direct registration is
+rejected with `hosted_local_signer_required`, no x402 payment was charged; switch
+to the local profile flow instead of retrying the hosted write.
 
 ## Tools
 
@@ -31,9 +37,7 @@ This skill is adapted from upstream `sns-skill` plus SAP MCP's
 - `sap_sns_check_ownership`
 - `sap_sns_get_domain_pda`
 - `sap_sns_get_record_pda`
-- `sap_sns_build_register_domain_transaction`
 - `sap_sns_build_manage_record_transaction`
-- `sap_sns_build_set_primary_domain_transaction`
 - `sap_sns_register_agent_domain`
 - `sns_registerDomain`
 - `sns_resolveDomain`
@@ -46,6 +50,24 @@ This skill is adapted from upstream `sns-skill` plus SAP MCP's
 
 - Never assume mainnet/devnet; read the profile RPC first.
 - Never read the local wallet file.
+- `sap_sns_check_ownership` canonical field is `owner`; `wallet` is accepted as
+  an alias for agent ergonomics.
 - Prefer build/preview/sign flows over direct register flows when the user
   needs to review transaction details.
+- Do not claim `sap_sns_build_register_domain_transaction` exists unless it is
+  returned by `tools/list`.
+- Do not route hosted direct registration through x402; hosted accountless
+  servers reject local-signer writes before payment.
+
+## SAP Agent Identity Link
+
+For “use my .sol as my SAP identity”:
 
+1. Resolve or check ownership with `sap_sns_resolve_wallet` and
+   `sap_sns_check_ownership`.
+2. If a record must change from hosted mode, build the unsigned record
+   transaction and finalize with `sap_payments_finalize_transaction`.
+3. Update the agent metadata JSON to include:
+   `{ "sns": { "domain": "name.sol" } }`.
+4. Call local `sap_payments_update_agent` with the public `metadataUri` and
+   `confirm: true`.

package/smithery.config.schema.json

@@ -54,6 +54,13 @@
       "description": "Copy this command into a local terminal when paid/write tools should work from a non-custodial user profile.",
       "const": "npm exec --yes --package @oobe-protocol-labs/sap-mcp-server -- sap-mcp-config wizard",
       "default": "npm exec --yes --package @oobe-protocol-labs/sap-mcp-server -- sap-mcp-config wizard"
+    },
+    "submitRelayUrl": {
+      "type": "string",
+      "title": "Signed transaction submit relay",
+      "description": "Optional submit-only relay for already-signed Solana transactions returned by local sap_payments_finalize_transaction. The relay never signs and never receives keypair bytes.",
+      "const": "https://mcp.sap.oobeprotocol.ai/tx/submit",
+      "default": "https://mcp.sap.oobeprotocol.ai/tx/submit"
     }
   }
 }