pg-aiguide

Search Documentation

search_docs

Read-onlyIdempotent

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

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

Input Schema

Name	Required	Description
`limit`	Yes	The maximum number of matches to return. Defaults to 20.
`query`	Yes	The search query. Used for BM25 when keyword or hybrid search applies, and for the embedding when semantic or hybrid search applies.
`source`	Yes	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.
`semanticWeight`	Yes	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).

Output Schema

Name	Required	Description	Default
`results`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 21, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed6 schema fields changedApr 23, 2026

changedInput schema / properties / limit / description

Previous value: -"The maximum number of matches to return. If not provided, default is 10."New value: +"The maximum number of matches to return. Defaults to 20."

changedInput schema / properties / query / description

Previous value: -"The search query. For semantic search, use natural language. For keyword search, provide keywords."New value: +"The search query. Used for BM25 when keyword or hybrid search applies, and for the embedding when semantic or hybrid search applies."

removedInput schema / properties / search_type

Removed value: -{
-  "description": "The type of search to perform. \"semantic\" uses natural language vector similarity, \"keyword\" uses BM25 keyword matching.",
-  "enum": [
-    "semantic",
-    "keyword"
-  ],
-  "type": "string"
-}

addedInput schema / properties / semanticWeight

Added value: +{
+  "anyOf": [
+    {
+      "maximum": 1,
+      "minimum": 0,
+      "multipleOf": 0.1,
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "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)."
+}

changedInput schema / required

Previous value: -[
-  "source",
-  "search_type",
-  "query",
-  "limit"
-]New value: +[
+  "source",
+  "query",
+  "limit",
+  "semanticWeight"
+]

changedOutput schema / properties / results / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "content": {
-        "description": "The content of the documentation entry.",
-        "type": "string"
-      },
-      "distance": {
-        "description": "The distance score indicating the relevance of the entry to the query. Lower values indicate higher relevance.",
-        "type": "number"
-      },
-      "id": {
-        "description": "The unique identifier of the documentation entry.",
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "metadata": {
-        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "content",
-      "metadata",
-      "distance"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "content": {
-        "description": "The content of the documentation entry.",
-        "type": "string"
-      },
-      "id": {
-        "description": "The unique identifier of the documentation entry.",
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "metadata": {
-        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
-        "type": "string"
-      },
-      "score": {
-        "description": "The score indicating the relevance of the entry to the keywords. Higher values indicate higher relevance.",
-        "type": "number"
-      }
-    },
-    "required": [
-      "id",
-      "content",
-      "metadata",
-      "score"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "content": {
+        "description": "The content of the documentation entry.",
+        "type": "string"
+      },
+      "distance": {
+        "description": "The distance score indicating the relevance of the entry to the query. Lower values indicate higher relevance.",
+        "type": "number"
+      },
+      "id": {
+        "description": "The unique identifier of the documentation entry.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "metadata": {
+        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "content",
+      "metadata",
+      "distance"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "content": {
+        "description": "The content of the documentation entry.",
+        "type": "string"
+      },
+      "id": {
+        "description": "The unique identifier of the documentation entry.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "metadata": {
+        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
+        "type": "string"
+      },
+      "score": {
+        "description": "The score indicating the relevance of the entry to the keywords. Higher values indicate higher relevance.",
+        "type": "number"
+      }
+    },
+    "required": [
+      "id",
+      "content",
+      "metadata",
+      "score"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "content": {
+        "description": "The content of the documentation entry.",
+        "type": "string"
+      },
+      "id": {
+        "description": "The unique identifier of the documentation entry.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "metadata": {
+        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
+        "type": "string"
+      },
+      "rrf_score": {
+        "description": "Hybrid search: fused RRF score from combining semantic and keyword result rankings.",
+        "type": "number"
+      }
+    },
+    "required": [
+      "id",
+      "content",
+      "metadata",
+      "rrf_score"
+    ],
+    "type": "object"
+  }
+]

Changed9 schema fields changedMar 18, 2026

addedInput schema / properties / limit / anyOf

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / limit / description

Previous value: -"The maximum number of matches to return. Default is 10."New value: +"The maximum number of matches to return. If not provided, default is 10."

removedInput schema / properties / limit / maximum
```
Removed value: -9007199254740991
```
removedInput schema / properties / limit / minimum
```
Removed value: --9007199254740991
```
removedInput schema / properties / limit / type
```
Removed value: -"integer"
```

changedInput schema / properties / source / description

Previous value: -"The documentation source to search. \"tiger\" for Tiger Cloud and TimescaleDB, \"postgres\" for PostgreSQL, \"postgis\" for PostGIS spatial extension."New value: +"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."

changedInput schema / properties / source / enum

Previous value: -[
-  "tiger",
-  "postgres",
-  "postgis"
-]New value: +[
+  "tiger",
+  "postgres_14",
+  "postgres_15",
+  "postgres_16",
+  "postgres_17",
+  "postgres_18",
+  "postgis_3.3",
+  "postgis_3.4",
+  "postgis_3.5",
+  "postgis_3.6"
+]

removedInput schema / properties / version

Removed value: -{
-  "anyOf": [
-    {
-      "enum": [
-        "14",
-        "15",
-        "16",
-        "17",
-        "18",
-        "latest"
-      ],
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "The PostgreSQL major version (ignored when searching \"tiger\"). Recommended to assume the latest version if unknown. Only applicable when source is Postgres. Defaults to latest version."
-}

changedInput schema / required

Previous value: -[
-  "source",
-  "search_type",
-  "query",
-  "version",
-  "limit"
-]New value: +[
+  "source",
+  "search_type",
+  "query",
+  "limit"
+]

Changed4 schema fields changedMar 18, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```
addedInput schema / properties / limit / maximum
```
Added value: +9007199254740991
```
addedInput schema / properties / limit / minimum
```
Added value: +-9007199254740991
```

changedOutput schema / properties / results / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "content": {
-        "description": "The content of the documentation entry.",
-        "type": "string"
-      },
-      "distance": {
-        "description": "The distance score indicating the relevance of the entry to the query. Lower values indicate higher relevance.",
-        "type": "number"
-      },
-      "id": {
-        "description": "The unique identifier of the documentation entry.",
-        "type": "integer"
-      },
-      "metadata": {
-        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "content",
-      "metadata",
-      "distance"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "content": {
-        "$ref": "#/properties/results/items/anyOf/0/properties/content"
-      },
-      "id": {
-        "$ref": "#/properties/results/items/anyOf/0/properties/id"
-      },
-      "metadata": {
-        "$ref": "#/properties/results/items/anyOf/0/properties/metadata"
-      },
-      "score": {
-        "description": "The score indicating the relevance of the entry to the keywords. Higher values indicate higher relevance.",
-        "type": "number"
-      }
-    },
-    "required": [
-      "id",
-      "content",
-      "metadata",
-      "score"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "content": {
+        "description": "The content of the documentation entry.",
+        "type": "string"
+      },
+      "distance": {
+        "description": "The distance score indicating the relevance of the entry to the query. Lower values indicate higher relevance.",
+        "type": "number"
+      },
+      "id": {
+        "description": "The unique identifier of the documentation entry.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "metadata": {
+        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "content",
+      "metadata",
+      "distance"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "content": {
+        "description": "The content of the documentation entry.",
+        "type": "string"
+      },
+      "id": {
+        "description": "The unique identifier of the documentation entry.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "metadata": {
+        "description": "Additional metadata about the documentation entry, as a JSON encoded string.",
+        "type": "string"
+      },
+      "score": {
+        "description": "The score indicating the relevance of the entry to the keywords. Higher values indicate higher relevance.",
+        "type": "number"
+      }
+    },
+    "required": [
+      "id",
+      "content",
+      "metadata",
+      "score"
+    ],
+    "type": "object"
+  }
+]

Changed4 schema fields changedFeb 26, 2026

addedInput schema / properties / version / anyOf

Added value: +[
+  {
+    "enum": [
+      "14",
+      "15",
+      "16",
+      "17",
+      "18",
+      "latest"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / version / description

Previous value: -"The PostgreSQL major version (ignored when searching \"tiger\"). Recommended to assume the latest version if unknown."New value: +"The PostgreSQL major version (ignored when searching \"tiger\"). Recommended to assume the latest version if unknown. Only applicable when source is Postgres. Defaults to latest version."

removedInput schema / properties / version / enum

Removed value: -[
-  "14",
-  "15",
-  "16",
-  "17",
-  "18",
-  "latest"
-]

removedInput schema / properties / version / type
```
Removed value: -"string"
```

Changed2 schema fields changedFeb 25, 2026

changedInput schema / properties / source / description

Previous value: -"The documentation source to search. \"tiger\" for Tiger Cloud and TimescaleDB, \"postgres\" for PostgreSQL."New value: +"The documentation source to search. \"tiger\" for Tiger Cloud and TimescaleDB, \"postgres\" for PostgreSQL, \"postgis\" for PostGIS spatial extension."

changedInput schema / properties / source / enum

Previous value: -[
-  "tiger",
-  "postgres"
-]New value: +[
+  "tiger",
+  "postgres",
+  "postgis"
+]

First observedJan 31, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish readOnlyHint=true and idempotentHint=true. Beyond that, the description adds meaningful behavioral context: hybrid retrieval, BM25/vector modes, and RRF fusion for mid-range semanticWeight values. It does not cover rate limits or auth, but the added search behavior is substantive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three tight sentences with no wasted language. It front-loads the core action and search method, then gives the key semanticWeight guidance and source support.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given complete schema descriptions, annotations, and an output schema, the description contains what an agent needs to select and invoke the tool correctly. It need not explain return values or every parameter because those are covered structurally.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description still adds value by explaining that intermediate semanticWeight values fuse rankings with RRF and by summarizing supported source families, although much of the parameter detail is already in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: search documentation. It also names the retrieval methods (hybrid semantic/vector and keyword/BM25), making the tool's core purpose unambiguous and distinguishable from an unrelated sibling like view_skill.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explains how to configure semanticWeight for keyword-only, semantic-only, or blended search, which is useful operational guidance. However, it does not explicitly say when to use this tool versus alternatives or state any exclusions, so usage is only implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All pg-aiguide tools Inspect

Try in Browser

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.