search_companies

Search NZX-listed companies by name or ticker. Returns company list with sector, market cap. Use this to find a company ticker before calling other tools.

Server NZXplorer MCP Server mambaventures/nzxplorer-mcp-server
Category Read
Risk class Low
Parameters 30 required

What search_companies does on NZXplorer MCP Server

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

ParameterTypeRequiredDescription
limit number Max results (default 10)
search string Company name or ticker to search for (e.g. "air new zealand" or "AIR")
sector string Filter by sector (e.g. "Energy", "Healthcare")

Parameters from the server's own tool schema.

Why search_companies needs a policy

This is a straightforward search and retrieval operation that queries existing data without creating, modifying, deleting, or executing anything. It has minimal blast radius if misused by an AI agent—returning public market data poses no financial or operational risk. Classified as Read with low severity.

From the tool's definition The tool 'search_companies' retrieves and returns company data (name, ticker, sector, market cap) from a stock market database.

Questions about search_companies

What does the search_companies tool do? +

Search NZX-listed companies by name or ticker. Returns company list with sector, market cap. Use this to find a company ticker before calling other tools. It is categorised as a Read tool in the NZXplorer MCP Server MCP Server, which means it retrieves data without modifying state.

What parameters does search_companies accept? +

search_companies accepts 3 parameters: limit, search, sector. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on search_companies? +

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

What risk level is search_companies? +

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

Can I rate-limit search_companies? +

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

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

search_companies is provided by the NZXplorer MCP Server MCP server (mambaventures/nzxplorer-mcp-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.