magento_grep

Exact text search (grep) across Magento PHP/XML/JS files. Unlike magento_search (semantic/vector), this finds EVERY occurrence of a literal string or regex pattern. Use for: finding all call sites of a method, all usages of a class name, all config references. Returns file:line:content for each m...

Server Magector magector
Category Read
Risk class Low
Parameters 00 required

What magento_grep does on Magector

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

Why magento_grep needs a policy

This is a pure query/retrieval tool that searches for text patterns in code files without modifying, deleting, or executing anything. It enables code exploration and analysis (finding call sites, class usages, config references) with read-only semantics. The low severity reflects minimal blast radius—even if an agent misuses pattern matching, no data is altered or executed.

From the tool's definition Tool performs 'exact text search (grep)' and 'finds EVERY occurrence of a literal string or regex pattern' across files, returning 'file:line:content' matches. No modification, deletion, or execution capability described.

Risk signalsBulk/mass operation — affects multiple targets

Questions about magento_grep

What does the magento_grep tool do? +

Exact text search (grep) across Magento PHP/XML/JS files. Unlike magento_search (semantic/vector), this finds EVERY occurrence of a literal string or regex pattern. Use for: finding all call sites of a method, all usages of a class name, all config references. Returns file:line:content for each match. It is categorised as a Read tool in the Magector MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on magento_grep? +

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

What risk level is magento_grep? +

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

Can I rate-limit magento_grep? +

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

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

magento_grep is provided by the Magector MCP server (magector). 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.