inbox_previews

Preview pending inbox messages without consuming them and without returning full message bodies.

Server Agent Bus mustaphasteph/agent-bus
Category Read
Risk class Low
Parameters 00 required

What inbox_previews does on Agent Bus

AI agents call inbox_previews to retrieve information from Agent Bus without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Why inbox_previews needs a policy

This tool retrieves or queries pending messages for preview purposes only, with no side effects, modification, or consumption of data. It falls squarely into the Read category.

From the tool's definition Tool name 'inbox_previews' and description state it 'preview[s] pending inbox messages without consuming them' — a read-only operation that retrieves data without modification, deletion, or execution.

Questions about inbox_previews

What does the inbox_previews tool do? +

Preview pending inbox messages without consuming them and without returning full message bodies. It is categorised as a Read tool in the Agent Bus MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on inbox_previews? +

Register the Agent Bus MCP server in PolicyLayer and add a rule for inbox_previews: 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 Agent Bus. Nothing to install.

What risk level is inbox_previews? +

inbox_previews is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit inbox_previews? +

Yes. Add a rate_limit block to the inbox_previews 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.

How do I block inbox_previews completely? +

Set action: deny in the PolicyLayer policy for inbox_previews. 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.

What MCP server provides inbox_previews? +

inbox_previews is provided by the Agent Bus MCP server (mustaphasteph/agent-bus). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.