sap_premium_stream_poll
Long-poll buffered premium stream events for an active session. Returns events that have been delivered to the server-side event buffer since the last poll. This is the MCP-compatible alternative to holding open an SSE connection — call this tool periodically to drain the event buffer. This tool ...
This record as markdown: /tools/oobe-protocol-labs-sap-mcp-server/sap-premium-stream-poll.md
What sap_premium_stream_poll does on Sap
AI agents call sap_premium_stream_poll to retrieve information from Sap without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
waitMs | number | — | Long-poll wait timeout in milliseconds. If no events are available, the tool waits up to this duration for events to arrive before returning. Default: 15000 (15 |
eventType | string | — | Optional event type filter. Only events matching this type are returned. |
maxEvents | number | — | Maximum number of events to return in a single poll. Default: 10, max: 100. |
sessionId | string | Yes | Active premium session id whose stream events should be polled. |
sinceEventId | string | — | Optional event id cursor. Only events delivered after this event id are returned. Use the last event id from the previous poll to paginate. |
Parameters from the server's own tool schema.
Why sap_premium_stream_poll is rated Low
Tool retrieves buffered events without side effects; read-only polling mechanism.
From the tool's definition Long-poll buffered premium stream events for an active session, returns events, transport-agnostic.
Attacks that exploit this kind of access
The rule that runs sap_premium_stream_poll safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Sap, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For sap_premium_stream_poll, this is the rule to start with:
sap_premium_stream_poll is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Sap, apply this rule, and every sap_premium_stream_poll call is checked against it from then on.
Questions about sap_premium_stream_poll
Long-poll buffered premium stream events for an active session. Returns events that have been delivered to the server-side event buffer since the last poll. This is the MCP-compatible alternative to holding open an SSE connection — call this tool periodically to drain the event buffer. This tool is transport-agnostic: because it is a standard MCP tool call (request/response), it works over any MCP transport including stdio, streamable-http, and WebSocket-based MCP transports. There is no need for a separate WebSocket endpoint — this poll tool IS the WebSocket-compatible consumption path. Events are returned oldest-first. Use the sinceEventId cursor from the last poll to fetch only new events. If no events are available, the tool will wait up to waitMs (default 15s, max 30s) for events to arrive before returning an empty array — this gives near-real-time delivery without repeated polling. Set waitMs=0 for instant return. 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. It is categorised as a Read tool in the Sap MCP Server, which means it retrieves data without modifying state.
sap_premium_stream_poll accepts 5 parameters: waitMs, eventType, maxEvents, sessionId, sinceEventId. Required: sessionId. The full parameter table on this page comes from the server's own tool schema.
Register the Sap MCP server in PolicyLayer and add a rule for sap_premium_stream_poll: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Sap. Nothing to install.
sap_premium_stream_poll is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the sap_premium_stream_poll rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for sap_premium_stream_poll. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
sap_premium_stream_poll is provided by the Sap MCP server (https://mcp.sap.oobeprotocol.ai/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Sap, and thousands of servers like it.
This server
Across the catalogue