# Search the FAQ

> The entries of manitu's FAQ that answer a question best - in German.

- Effect: Read - Changes nothing.
- Idempotent: yes
- Stability: stable
- MCP tool: `manitu_public_faq_search` on https://mcp.manitu.de/mcp
- REST: `POST https://api.manitu.de/v1/public/faq/search`
- Page: /reference/public/faq/search/

## MCP tool

`manitu_public_faq_search`

### Description for the model

Searches manitu's public FAQ - answers to common questions about web hosting, domains, e-mail, servers, the customer panel, contracts and billing - and returns the entries that match best, each with its question, category and link. The FAQ is in German: search with German words, and tell the customer in his language. To read an answer, call [`manitu_public_faq_get`](/reference/public/faq/get.md) with its faq_id. Without a query and with a category_id (from [`manitu_public_faq_category_list`](/reference/public/faq/category/list.md)) it lists the entries of that category instead. Use it when the customer asks how something works at manitu, what is possible or why something fails, before answering from general knowledge. The answers are general, never about this account. Changes nothing.

### Arguments

- `query` (string) - The question, or its main words - in German, as the FAQ is: "PHP-Version ändern", "DKIM einrichten". Leave it out with a category_id to list the entries of the category. (minLength `3`; maxLength `200`; pattern `"^[^\\x00-\\x1F\\x7F]*$"`)
- `category_id` (integer | string) - Only entries of this category and the ones below it - from [`manitu_public_faq_category_list`](/reference/public/faq/category/list.md) or an earlier hit. (pattern `"^[1-9][0-9]*$"`; minimum `1`)
- `max_results` (integer) - How many at most; when left out 5 for a search, 25 for the entries of a category. (minimum `1`; maximum `50`)

### Example

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_public_faq_search",
    "arguments": {}
  }
}
```

## REST

`POST https://api.manitu.de/v1/public/faq/search`

### Description

Searches manitu's public FAQ - web hosting, domains, e-mail, servers, the customer panel, contracts and billing - and returns the entries that match the query best, each with its question, category and link. The FAQ is in German and searched with German words. Without a query and with a category_id ([`POST /v1/public/faq/category/list`](/reference/public/faq/category/list.md)) it lists the entries of that category instead. The answer of one entry is [`POST /v1/public/faq/get`](/reference/public/faq/get.md). The answers are general, never about an account. Changes nothing.

### Authentication

None - this operation needs no credential.

### Request body

JSON; unknown fields are refused.

- `query` (string) - The question, or its main words - in German, as the FAQ is: "PHP-Version ändern", "DKIM einrichten". Leave it out with a category_id to list the entries of the category. (minLength `3`; maxLength `200`; pattern `"^[^\\x00-\\x1F\\x7F]*$"`)
- `category_id` (integer | string) - Only entries of this category and the ones below it - from [`POST /v1/public/faq/category/list`](/reference/public/faq/category/list.md) or an earlier hit. (pattern `"^[1-9][0-9]*$"`; minimum `1`)
- `max_results` (integer) - How many at most; when left out 5 for a search, 25 for the entries of a category. (minimum `1`; maximum `50`)

### Response

In `data`; the rest of the body as on every call.

- `faq_list` (array of object, required) - The hits, the best first - or the entries of the category, by question; empty when none matches.
  - `faq_list[].faq_id` (integer, required) - The entry - for [`POST /v1/public/faq/get`](/reference/public/faq/get.md).
  - `faq_list[].question` (string, required) - The question, in German.
  - `faq_list[].category` (object | null, required) - Where the entry is filed; null: nowhere.
    - `faq_list[].category.category_id` (integer, required) - The category - for category_id of [`POST /v1/public/faq/search`](/reference/public/faq/search.md), to browse it.
    - `faq_list[].category.path` (string, required) - Its titles from the top, in German, e.g. "Webhosting > PHP".
  - `faq_list[].url` (string, required) - The entry on www.manitu.de - to give the customer.

### Statuses

- `200` Success.
- `400` The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.
- `429` Too many calls. The Retry-After header says when to try again.
- `500` The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.
- `503` The channel this operation forwards through is unavailable.

### Example

```sh
curl -X POST \
  'https://api.manitu.de/v1/public/faq/search' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## Example result

```json
{
  "faq_list": [
    {
      "faq_id": 12345,
      "question": "string",
      "category": {
        "category_id": 12345,
        "path": "/web"
      },
      "url": "https://www.example.com/"
    }
  ]
}
```
