by timescale
pg-aiguide — Version-aware PostgreSQL docs and best practices tailored for AI coding assistants. Improve queries, migrat
Provides AI coding assistants with semantic search across PostgreSQL documentation and curated best practices to generate better, more modern PostgreSQL code.
pg-aiguide is an official MCP server published by timescale that provides AI assistants with tools and capabilities via the Model Context Protocol. pg-aiguide — Version-aware PostgreSQL docs and best practices tailored for AI coding assistants. Improve queries, migrat It is categorized under databases, developer tools. This server exposes 3 tools that AI clients can invoke during conversations and coding sessions.
You can install pg-aiguide in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server supports remote connections over HTTP, so no local installation is required.
Apache-2.0
pg-aiguide is released under the Apache-2.0 license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Enable Claude to query your database directly using natural language
Example
Ask 'Show me top 10 customers by revenue this month' and get SQL results instantly
Eliminate manual SQL writing for ad-hoc queries, get insights 10x faster
Generate complex reports and analytics without leaving conversation
Example
Analyze sales trends, cohort retention, user behavior patterns conversationally
Democratize data access—non-technical team members can query databases
Understand database structure, relationships, and data models
Example
'Explain the user_orders table schema and its relationships'
Onboard engineers faster, explore unfamiliar databases efficiently
Share your MCP server with the developer community
pg-aiguide reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
I recommend pg-aiguide for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
Strong directory entry: pg-aiguide surfaces stars and publisher context so we could sanity-check maintenance before adopting.
pg-aiguide reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
pg-aiguide has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
According to our notes, pg-aiguide benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
Useful MCP listing: pg-aiguide is the kind of server we cite when onboarding engineers to host + tool permissions.
Strong directory entry: pg-aiguide surfaces stars and publisher context so we could sanity-check maintenance before adopting.
pg-aiguide is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
pg-aiguide is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
showing 1-10 of 32
AI-optimized PostgreSQL expertise for coding assistants
pg-aiguide helps AI coding tools write dramatically better PostgreSQL code. It provides:
Use it either as:
AI coding tools often generate Postgres code that is:
pg-aiguide fixes that by giving AI agents deep, versioned PostgreSQL knowledge and proven patterns.
https://github.com/user-attachments/assets/5a426381-09b5-4635-9050-f55422253a3d
<details> <summary>Video Transcript </summary>Prompt given to Claude Code:
Please describe the schema you would create for an e-commerce website two times, first with the tiger mcp server disabled, then with the tiger mcp server enabled. For each time, write the schema to its own file in the current working directory. Then compare the two files and let me know which approach generated the better schema, using both qualitative and quantitative reasons. For this example, only use standard Postgres.
Result (summarized):
GENERATED ALWAYS AS IDENTITY, NULLS NOT DISTINCT)Conclusion: pg-aiguide produces more robust, performant, maintainable schemas.
</details>pg-aiguide is available as a public MCP server:
https://mcp.tigerdata.com/docs
<details> <summary>Manual MCP configuration using JSON</summary>{
"mcpServers": {
"pg-aiguide": {
"url": "https://mcp.tigerdata.com/docs"
}
}
}
Or it can be used as a Claude Code Plugin:
claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide
This repo serves as a claude code marketplace plugin. To install, run:
claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide
This plugin uses the skills available in the skills directory as well as our
publicly available MCP server endpoint hosted by TigerData for searching PostgreSQL documentation.
Run the following to add the MCP server to codex:
codex mcp add --url "https://mcp.tigerdata.com/docs" pg-aiguide
One-click install:
Or add the following to .cursor/mcp.json
{
"mcpServers": {
"pg-aiguide": {
"url": "https://mcp.tigerdata.com/docs"
}
}
}
Run the following to add the MCP server to Gemini CLI:
gemini mcp add -s user pg-aiguide "https://mcp.tigerdata.com/docs" -t http
Click the button to install:
Click the button to install:
Alternatively, run the following to add the MCP server to VS Code:
code --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'
Click the button to install:
Alternatively, run the following to add the MCP server to VS Code Insiders:
code-insiders --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'
Add the following to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pg-aiguide": {
"serverUrl": "https://mcp.tigerdata.com/docs"
}
}
}
Once installed, pg-aiguide can answer Postgres questions or design schemas.
Simple schema example prompt
Create a Postgres table schema for storing usernames and unique email addresses.
Complex schema example prompt
You are a senior software engineer. You are given a task to generate a Postgres schema for an IoT device company. The devices collect environmental data on a factory floor. The data includes temperature, humidity, pressure, as the main data points as well as other measurements that vary from device to device. Each device has a unique id and a human-readable name. We want to record the time the data was collected as well. Analysis for recent data includes finding outliers and anomalies based on measurements, as well as analyzing the data of particular devices for ad-hoc analysis. Historical data analysis includes analyzing the history of data for one device or getting statistics for all devices over long periods of time.
search_docs
Unified search tool supporting semantic (vector similarity) and keyword (BM25) search across multiple documentation sources:
postgres - Official PostgreSQL manual, scoped by versiontiger - Tiger Data's documentation (TimescaleDB and ecosystem)postgis - PostGIS spatial extension documentationview_skill
Exposes curated, opinionated PostgreSQL best-practice skills used automatically by AI coding assistants.
These skills provide guidance on:
Supported today:
Coming soon:
We welcome contributions for additional extensions and tools.
See DEVELOPMENT.md for:
We welcome:
Apache 2.0
Run data quality queries to catch anomalies and inconsistencies
Example
Find duplicate records, missing values, orphaned foreign keys automatically
Maintain data integrity with less manual SQL work
Prerequisites
Time Estimate
15-30 minutes including configuration and testing
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
MCP server acts as bridge between Claude and database, translating natural language to SQL queries and returning results in structured format.
Protocols
Compatibility
✓ Use when
Use for ad-hoc data queries, exploratory analysis, report generation, schema exploration, and democratizing data access. Best for read-heavy analytics workloads.
✗ Avoid when
Avoid for production write operations, mission-critical transactions, real-time OLTP workloads, or when database contains sensitive PII without proper access controls. Use read replicas, not primary.