Title100/100
Search Documentation
The title clearly communicates the tool’s action and subject. Keep it concise.
Description70/100
Search documentation with hybrid semantic (vector) and keyword (BM25) search. Use semanticWeight to choose keyword-only (0), semantic-only (1), or a blend; mid values fuse rankings with RRF. Supports Tiger Cloud (TimescaleDB), PostgreSQL, and PostGIS.
The description explains the capability, when to use it, and what to expect.
Inputs81/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source
The documentation source to search. "tiger" for Tiger Cloud and TimescaleDB, "postgres" for PostgreSQL, "postgis" for PostGIS spatial extension. Specific versions provided with _X.X suffixes.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
The search query. Used for BM25 when keyword or hybrid search applies, and for the embedding when semantic or hybrid search applies.
Clear enough to supply this argument.
limit
The maximum number of matches to return. Defaults to 20.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
semanticWeight
Controls the balance between semantic and keyword search. 0 = keyword only, 0.5 = equal mix, 1 = semantic only. Default is 0.7 (favor semantic search).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations50/100
Declare destructiveHint, openWorldHint based on the tool’s actual behavior.
{
"title": "Search Documentation",
"readOnlyHint": true,
"idempotentHint": true
}Output schema81/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"content",
"metadata",
"distance"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The unique identifier of the documentation entry."
},
"content": {
"type": "string",
"description": "The content of the documentation entry."
},
"distance": {
"type": "number",
"description": "The distance score indicating the relevance of the entry to the query. Lower values indicate higher relevance."
},
"metadata": {
"type": "string",
"description": "Additional metadata about the documentation entry, as a JSON encoded string."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"content",
"metadata",
"score"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The unique identifier of the documentation entry."
},
"score": {
"type": "number",
"description": "The score indicating the relevance of the entry to the keywords. Higher values indicate higher relevance."
},
"content": {
"type": "string",
"description": "The content of the documentation entry."
},
"metadata": {
"type": "string",
"description": "Additional metadata about the documentation entry, as a JSON encoded string."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"content",
"metadata",
"rrf_score"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The unique identifier of the documentation entry."
},
"content": {
"type": "string",
"description": "The content of the documentation entry."
},
"metadata": {
"type": "string",
"description": "Additional metadata about the documentation entry, as a JSON encoded string."
},
"rrf_score": {
"type": "number",
"description": "Hybrid search: fused RRF score from combining semantic and keyword result rankings."
}
},
"additionalProperties": false
}
]
}
}
},
"additionalProperties": false
}