Register Premium Webhook Relay (Buffer-Only)
sap_premium_webhook_relayRegisters a buffer-only webhook subscription for an active premium session. Unlike sap_premium_webhook_register, this does not require a public HTTPS endpoint — events matching the subscription are buffered server-side in the event store and the agent consumes them via sap_premium_stream_poll or sap_premium_stream_flush. Use this when the agent runs locally or behind NAT and cannot expose a publicly reachable HTTPS callback URL. The session must be active (activated via sap_premium_activate_session). Events are filtered to the exact event ids listed in the request.
SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when signing is required.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | Yes | Exact event ids to buffer and deliver via poll/flush. At least one event id is required. | |
| filters | No | Optional narrow filters applied to the provider subscription, forwarded to the delivery loop. | |
| sessionId | Yes | Active premium session id to buffer webhook events for. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| consumption | Yes | Consumption guidance listing the poll and flush tool names the agent should use to drain the buffer. | |
| subscription | Yes | Relay webhook subscription record with subscriptionId, targetUrl (relay://buffer), events, and delivery stats. Null if registration failed. |