# search_docs

Full-text search across the product documentation. Returns the best-matching pages with title, description, canonical URL, matched section headings, and a snippet. Omit product to search every product at once, or pass one of the ids from list_products to scope it.

Agent View of the PolicyLayer registry record for `search_docs`. HTML page: https://policylayer.com/tools/com-freebatteryfactory-docs/search-docs

## Facts

- Tool: `search_docs`
- Server: Docs (`https://freebatteryfactory.com/mcp`) — https://policylayer.com/tools/com-freebatteryfactory-docs.md
- Homepage: https://github.com/https://freebatteryfactory.com/mcp
- Risk category: Read (Low risk)
- Registry record: grade C, identity unverified
- Server auth posture: open
- Server CORS policy: *
- Server rate-limited: no
- Parameters: 3 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no | Maximum results to return (default 8, max 25). |
| `query` | string | yes | Search terms, e.g. "boundary hysteresis" or "deterministic replay". |
| `product` | string | no | Optional product id from list_products to scope the search. Omit to search all products. |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_docs",
    "arguments": {
      "query": "<query>"
    }
  }
}
```

## Why search_docs is rated Low

search_docs is a query/search operation that retrieves documentation without side effects. It does not create, modify, delete, or execute code. The only parameters are search scope filters (product selection), which constrain what data is returned rather than alter any state. This is a canonical Read operation with minimal security risk.

From the tool's own definition: "Tool performs 'Full-text search' and 'Returns the best-matching pages' with no modification or deletion capabilities. The description explicitly indicates retrieval only ('read the Free Battery Factory docs')."

Risk signals: Bulk/mass operation — affects multiple targets

## Use case

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

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Docs:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "search_docs": {}
  }
}
```

## Other tools on Docs (3)

- `get_doc` — Read — https://policylayer.com/tools/com-freebatteryfactory-docs/get-doc.md
- `get_llms_full` — Read — https://policylayer.com/tools/com-freebatteryfactory-docs/get-llms-full.md
- `list_products` — Read — https://policylayer.com/tools/com-freebatteryfactory-docs/list-products.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-freebatteryfactory-docs · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/com-freebatteryfactory-docs