# Tool search

Faro's search is semantic over every public tool in every active namespace. Agents should pass natural-language queries verbatim from their user's intent.

## HTTP

```
GET https://api.askfaro.com/tools/search?q={query}&limit={n}
```

- `q` — natural-language query, e.g. `find+the+CEO+of+a+company`
- `limit` — default 10, max 50
- No auth required for search.

Each result:

```json
{
  "namespace": "...",
  "name": "...",
  "short_description": "...",
  "input_schema": { ... },
  "pricing": { "pricing_mode": "fixed_per_request", "fixed_credit_cost": 50, "charge_on": "success" }
}
```

The `input_schema` is included in search results so you can invoke without a second round-trip.

## CLI

```
faro search "find the CEO of a company"
```

Outputs the same JSON when stdout is piped.

## Browse

- All active namespaces: https://api.askfaro.com/namespaces/public
- Single namespace: https://api.askfaro.com/namespaces/public/{slug}
- Single tool: https://api.askfaro.com/tools/{namespace}/{tool_name}
- Markdown listing mirror: https://askfaro.com/llms/namespaces/{namespace}.md
- Markdown tool mirror: https://askfaro.com/llms/namespaces/{namespace}/{tool_name}.md
- Public sitemap: https://askfaro.com/sitemap.xml