timescale/pg-aiguide — an AI tool — sits at 1.8k GitHub stars in the AI Tools space. MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
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):
4× more constraints
55% more indexes (including partial/expression indexes)
PG17-recommended patterns
Modern features (GENERATED ALWAYS AS IDENTITY, NULLS NOT DISTINCT)
Cleaner naming & documentation
Conclusion: pg-aiguide produces more robust, performant, maintainable schemas.
🚀 Quickstart
Agent Skills
Install curated PostgreSQL best-practice skills for your AI coding agent:
Works with Claude Code, Cursor, Codex, Gemini CLI, VS Code, and 40+ other agents.
For even deeper PostgreSQL knowledge, also add the MCP server to give your agent semantic search over the official PostgreSQL, TimescaleDB, and PostGIS manuals.
MCP Server
For semantic search over PostgreSQL, TimescaleDB, and PostGIS documentation, add the public MCP server:
claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide
Install by environment
Claude Code
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.
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.
Features
Documentation Search (MCP Tools)
search_docs
Unified search tool supporting semantic (vector similarity) and keyword (BM25) search across multiple documentation sources:
postgres - Official PostgreSQL manual, scoped by version
tiger - Tiger Data's documentation (TimescaleDB and ecosystem)
postgis - PostGIS spatial extension documentation
Skills (AI-Optimized Best Practices)
view_skill
Exposes curated, opinionated PostgreSQL best-practice skills used automatically by AI coding assistants.
These skills provide guidance on:
Schema design
Indexing strategies
Data types
Data integrity and constraints
Naming conventions
Performance tuning
Modern PostgreSQL features
🔌 Ecosystem Documentation
Supported today:
TimescaleDB (docs + skills)
PostGIS (docs)
Coming soon:
pgvector
We welcome contributions for additional extensions and tools.
How active is development on timescale/pg-aiguide?
The most recent commit recorded on timescale/pg-aiguide was 1 month ago, based on the GitHub push timestamp. The repository has 103 forks — one of the better signals of community interest.
How does timescale/pg-aiguide compare to other AI Tools projects?
timescale/pg-aiguide is tracked by TopGit in the AI Tools category, with 1.8k GitHub stars and written in Python. Browse the AI Tools topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does timescale/pg-aiguide have?
timescale/pg-aiguide has 1.8k GitHub stars — refresh the page for the live number, or check github.com/timescale/pg-aiguide. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is timescale/pg-aiguide open source?
Yes — timescale/pg-aiguide ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/timescale/pg-aiguide.
What is timescale/pg-aiguide?
timescale/pg-aiguide (timescale/pg-aiguide) is a Python project on GitHub. From the project's own README: MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Where do I read more about timescale/pg-aiguide?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/timescale/pg-aiguide is the definitive source.
Read full README in the tab above.
Curious whether pg-aiguide is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about pg-aiguide.
/pg-aiguide
