Plan Premium Session
sap_premium_session_startFree premium session planner. Creates a bounded session plan for a stream, webhook, or premium tool capability before any x402 charge. Use it to validate plugin id, capability id, requested units, TTL, provider readiness, and estimated price; paid activation happens only on the delivery rail.
SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. 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 |
|---|---|---|---|
| consumer | No | Optional runtime, agent id, wallet, or application identifier requesting the premium session plan. | |
| pluginId | Yes | Premium plugin id from sap_premium_plugin_catalog, for example sap-premium-market-data. | |
| ttlSeconds | No | How long the unpaid planning object should remain valid. Clamped between 60 and 3600 seconds. | |
| maxPriceUsd | No | Optional buyer budget cap in USD. Agents should compare this to estimatedPriceUsd before paid activation. | |
| capabilityId | Yes | Capability id from sap_stream_catalog or sap_webhook_catalog, for example jupiter.quote.delta. | |
| capabilityType | Yes | Capability type being planned: stream, webhook, or tool. | |
| requestedUnits | No | Requested paid units for the session. Streams use minutes, webhooks use events, tools use sessions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session | Yes | Premium session plan. This is a planning object and must be paid/activated by the delivery rail before live data is delivered. | |
| monetization | Yes | x402/pay.sh payment guidance for the premium stream or webhook activation rail. | |
| providerStatus | Yes | Provider readiness at the moment the session was planned. |