search_by_body

Search messages containing specific text in the body with optional date range. Auto-connects if not already connected.

Server Mcp Mail Server mcp-mail-server
Category Read
Risk class Low
Parameters 00 required

What search_by_body does on Mcp Mail Server

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

Why search_by_body needs a policy

This tool performs a search query on email message bodies, which is fundamentally a Read operation - it retrieves information without side effects. However, severity is medium rather than low because email contents can be sensitive (personal, financial, or confidential information), and the search capability could be misused to locate specific sensitive messages if an AI agent is compromised or given adversarial…

From the tool's definition Tool description states 'Search messages containing specific text in the body' - this is a query operation that retrieves data without modification.

Questions about search_by_body

What does the search_by_body tool do? +

Search messages containing specific text in the body with optional date range. Auto-connects if not already connected. It is categorised as a Read tool in the Mcp Mail Server MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on search_by_body? +

Register the Mcp Mail Server MCP server in PolicyLayer and add a rule for search_by_body: 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 Mcp Mail Server. Nothing to install.

What risk level is search_by_body? +

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

Can I rate-limit search_by_body? +

Yes. Add a rate_limit block to the search_by_body 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 search_by_body completely? +

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

search_by_body is provided by the Mcp Mail Server MCP server (mcp-mail-server). 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.