diff --git a/tools/search.go b/tools/search.go
index 2a78f8e..002dc86 100644
--- a/tools/search.go
+++ b/tools/search.go
@@ -42,27 +42,37 @@
 		"properties": map[string]interface{}{
 			"query": map[string]interface{}{
 				"type":        "string",
-				"description": "The search query (word, phrase, or pattern)",
+				"description": "The search query. Supports different query languages like Poliqarp, CosmasII, or Annis depending on the selected query_language parameter.",
+				"minLength":   1,
+				"maxLength":   1000,
+				"examples":    []string{"Haus", "[pos=NN]", "der /w1:5 Mann"},
 			},
 			"query_language": map[string]interface{}{
 				"type":        "string",
-				"description": "Query language: 'poliqarp' (default), 'cosmas2', or 'annis'",
-				"enum":        []string{"poliqarp", "cosmas2", "annis"},
+				"description": "Query language to use for parsing the search query. Supported languages: 'poliqarp' (default; extended Poliqarp QL), 'cosmas2' (corpus query syntax of COSMAS II), 'annis' (multi-layer annotation queries), 'cql' (corpus query language), 'cqp' (Corpus Query Processor syntax), 'fcsql' (Federated Content Search queries).",
+				"enum":        []string{"poliqarp", "cosmas2", "annis", "cql", "cqp", "fcsql"},
 				"default":     "poliqarp",
+				"examples":    []string{"poliqarp", "cosmas2", "annis", "cql", "cqp", "fcsql"},
 			},
 			"corpus": map[string]interface{}{
 				"type":        "string",
-				"description": "Virtual corpus query to filter search results (optional, when not provided searches all available data)",
+				"description": "Virtual corpus query to filter search results based on metadata fields. Supports boolean operations (& | !), comparison operators (= != < > in), and regular expressions (/pattern/). Use metadata fields like corpusSigle, textClass, pubDate, textType, availability, etc. When not provided, searches all available data accessible to the user.",
+				"pattern":     "^[a-zA-Z0-9._\\-\\s&|!=<>()/*\"']+$",
+				"examples":    []string{"corpusSigle = \"GOE\"", "textClass = \"politics\" & pubDate in 2020", "textType = \"news\" | textType = \"blog\"", "availability = /CC.*/ & textClass != \"fiction\""},
 			},
 			"count": map[string]interface{}{
 				"type":        "integer",
-				"description": "Number of results to return (max 100)",
-				"minimum":     1,
-				"maximum":     100,
+				"description": "Maximum number of search results to return. Higher values may increase response time. Use smaller values for faster responses when doing exploratory searches.",
+				"minimum":     0,
+				"maximum":     10000,
 				"default":     25,
+				"examples":    []interface{}{10, 25, 50, 100},
 			},
 		},
-		"required": []string{"query"},
+		"required":             []string{"query"},
+		"additionalProperties": false,
+		"title":                "KorAP Search Parameters",
+		"description":          "Parameters for searching text corpora using KorAP's powerful query languages and filtering capabilities.",
 	}
 }