{"name":"io.ddx.pg/archive","slug":"pg-archive","title":"pg.ddx.io: the PostgreSQL community's memory","description":"Every PostgreSQL mailing list since 1991, linked to the commits, code, commitfest and docs.","url":"https://mcp.market/server/pg-archive","rating":null,"grade":"C","score":65,"certified":false,"status":"active","category":"productivity","tags":["productivity"],"presence":{"score":8,"stars":null,"forks":null,"downloads_week":null,"last_push_at":null,"license":null},"uptime":{"percent":96,"checks":28,"ok":27,"last_checked_at":"2026-11-04T07:20:40.745Z","last_ok_at":"2026-11-04T07:20:40.745Z","latency_ms":629},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":null,"website":"https://pg.ddx.io/","version":"2026.10.22","remotes":[{"type":"streamable-http","url":"https://pg.ddx.io/mcp"},{"type":"sse","url":"https://pg.ddx.io/mcp/sse"}],"packages":[],"tools":[{"name":"animal_history","description":"Run timeline for one animal. Filterable by branch and start cutoff; ordered newest first.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"branch":{"description":"Restrict to a single PG branch","type":"string"},"limit":{"description":"Max runs (1-1000, default 100)","type":"number"},"name":{"description":"Animal name","type":"string"},"since":{"description":"Only runs with started_at >= this RFC3339 timestamp","type":"string"}},"required":["name"]}},{"name":"animal_owner_contributions","description":"Animals run by one owner: list, branches each tracks, last status, first_seen_at and elapsed days since first observation.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"owner_email":{"description":"Owner email (exact)","type":"string"},"owner_name":{"description":"Owner name (exact)","type":"string"}},"required":[]}},{"name":"blame","description":"Per-line blame of a postgres file at any commit (code-history index): the commit that wrote each line, as `git blame` with git's default diff. ignore_revs (default true) passes through the pgindent/reformat commits of .git-blame-ignore-revs when they replaced lines one-for-one; reverse adds the commit that removed each line later on the version's branch. At most 2000 lines per call; commits lists author, date and subject per short sha. Not the same as git_blame, which returns a file's commit history.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"end_line":{"description":"Last line (default start_line + 1999)","type":"number"},"ignore_revs":{"description":"Pass through .git-blame-ignore-revs commits (default true)","type":"boolean"},"path":{"description":"Path from the repository root","type":"string"},"repository":{"description":"Repository; only postgres is in the code-history index for now (the default).","type":"string"},"reverse":{"description":"Also name the commit that later removed each line (default false)","type":"boolean"},"start_line":{"description":"First line (default 1)","type":"number"},"version":{"description":"Commit to read: a SHA or 7+ hex prefix, a branch (master, REL_17_STABLE), a tag (REL_17_0), a major (17, 9.6), a release (17.2), <ref>@YYYY-MM-DD (the branch's last commit by that day), or <ref>~N. Default: the newest release branch's head.","type":"string"}},"required":["path"]}},{"name":"blame_symbol","description":"Show the commit history that modified a symbol's file, filtered to the symbol's line range.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"qualified_name":{"description":"Fully qualified symbol name","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"browse_by_date","description":"Browse threads within a specific date range. Useful for exploring what was discussed during a particular time period.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"after":{"description":"Start date (YYYY-MM-DD or YYYYMMDD)","type":"string"},"before":{"description":"End date (YYYY-MM-DD or YYYYMMDD)","type":"string"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum threads to return (1-200, default 50)","type":"number"}},"required":["after","before"]}},{"name":"build_status_freshness","description":"Most recent :entry/last-build-at observation across all entries. Use to detect a stalled cfbot scraper.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"required":[]}},{"name":"buildfarm_overview","description":"High-level buildfarm health: animal count, recent run counts, currently-failing animals, top owners, OS / branch breakdown, and freshness.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"required":[]}},{"name":"calendar_feeds","description":"List every pg.ddx.io calendar feed (iCalendar URLs) with event counts: all events, regions, countries, conference series, the PostgreSQL release cycle, teams and organisations.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"required":[]}},{"name":"check_upstream_status","description":"Check whether a pull request has been merged upstream. Returns the latest patch series head commit and any merge information.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"pr_url":{"description":"Forge pull request URL","type":"string"}},"required":["pr_url"]}},{"name":"code_index_status","description":"Get code indexing statistics: files indexed, symbol counts by kind and language, edge count, community count.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"code_search","description":"Search the postgres source at any commit, branch, tag or date (or across history), from the code-history index: every line of every commit, byte-exact. A literal by default; match=regex for a PostgreSQL regex (^ and $ are per line; \\b \\< \\> as in grep), match=identifier for any of snake_case/CamelCase/UPPER spellings. File sets agree with `git grep -l` at the same commit. Results name the resolved sha and ref. complete=false means the totals are lower bounds (cut says why). With history (all | <rev> | A..B) it returns every matching line any commit in the range had, with the commit that added it and the one that removed it.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"budget_ms":{"description":"Time budget (100-15000, default 10000)","type":"number"},"case_sensitive":{"description":"Default true","type":"boolean"},"context":{"description":"Lines of context around each match (0-20, default 0)","type":"number"},"exclude":{"description":"Path globs to drop","items":{"type":"string"},"type":"array"},"history":{"description":"Search history instead of one commit: all, a rev (everything up to it on its line), or A..B (B's line after A, as git log A..B)","type":"string"},"include":{"description":"Path globs to keep, e.g. *.c, src/include/**/*.h","items":{"type":"string"},"type":"array"},"limit":{"description":"Results per page (1-2000, default 100)","type":"number"},"match":{"description":"How to read query (default literal)","enum":["literal","regex","identifier"],"type":"string"},"offset":{"description":"Results to skip (paging)","type":"number"},"output":{"description":"lines (default): each matching line with its number; files: paths with match counts; counts: [path, count] pairs","enum":["lines","files","counts"],"type":"string"},"paths":{"description":"Directories or globs to search under, e.g. src/backend/storage","items":{"type":"string"},"type":"array"},"query":{"description":"Text, regex or identifier to find","type":"string"},"repository":{"description":"Repository; only postgres is in the code-history index for now (the default).","type":"string"},"version":{"description":"Commit to read: a SHA or 7+ hex prefix, a branch (master, REL_17_STABLE), a tag (REL_17_0), a major (17, 9.6), a release (17.2), <ref>@YYYY-MM-DD (the branch's last commit by that day), or <ref>~N. Default: the newest release branch's head.","type":"string"}},"required":["query"]}},{"name":"codebase_map","description":"Get a directory-level overview of the codebase showing file counts and symbol counts per directory.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"depth":{"description":"Directory depth for grouping (default 2)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"combine_calendars","description":"Combine several pg.ddx.io calendar feeds into ONE subscription. Give feed paths or URLs as listed by calendar_feeds (e.g. events/region/europe, series/pgconf-eu, teams/committers, people/<8hex>, https://pg.ddx.io/cal/orgs/edb.ics; 1-200). Returns the combined feed's hash, canonical feed list, https url and webcal url. The same selection always yields the same URL.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"excludes":{"description":"Feeds whose events are removed from the combination (but not), e.g. events/country/rs or teams/security-team","items":{"type":"string"},"type":"array"},"feeds":{"description":"Feed paths or /cal/ URLs to combine","items":{"type":"string"},"type":"array"}},"required":["feeds"]}},{"name":"commit_buildfarm_status","description":"Buildfarm results for one PostgreSQL commit: every animal that built it, with branch, status (passed/failed/flapping), the failing stage and the log url, plus a {passed, failed, flapping, unknown} rollup. commit_sha is a SHA (>= 7 hex) or a branch, tag or major version (17, 9.6) for the commit it points at. Cite the commit SHA and the log urls.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commit_sha":{"description":"A commit SHA (>= 7 hex), or a branch, tag or major version (17, 9.6) for the commit it points at","type":"string"}},"required":["commit_sha"]}},{"name":"commit_history","description":"Everything linked to one commit: subject, author and date with its sha, the mail thread its Discussion: link names (participants resolved to people and organizations), the commitfest entry if tracked, and Discord mentions. For postgres also first_releases (per branch the change landed on: branch, sha, release e.g. 14.23 or null when unreleased, first_version incl. betas, shipped=false when it was reverted before that release), reverted_by (the commits that revert it, each with its own reverted_by) and reverts, read from git tags and commit messages, never guessed. commit_id takes a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N or a commit_id from another tool; repository defaults to postgres. The diff itself is not included (git_diff, or git_show_file for one file). Cite the sha and the thread's https://postgr.es/m/<message_id>.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commit_id":{"description":"The commit: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool.","type":"string"}},"required":["commit_id"]}},{"name":"commitfest_stats","description":"Overview of all indexed commitfests: count by status, top contributors (entries authored), distinct people / commitfests / entries totals.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"required":[]}},{"name":"contribution_summary","description":"Summary of contribution counts per release: unique people, distinct commits, role breakdown (count(DISTINCT commit_sha) per role, canonical authoritative repos only), and revert-commit count. Powers the /community hero strip.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"release":{"description":"Restrict to one release; empty = all releases.","type":"string"}},"required":[]}},{"name":"cross_reference","description":"What relates to one stored item, and what happened to it. ref: a Message-ID or message URL, a commit SHA or URL, a docs URL or page.html, a wiki URL or title, a commitfest URL, CVE-YYYY-NNNNN, or feature:<words> (matched to commitfest titles; ref.entries_used says which). Returns related threads, commits (with releases and reverted_by), docs, wiki pages, commitfest entries and people, each with why, strongest first: explicit links, shared identifiers, then similar topic. For a postgres commit, thread, entry or feature, timeline says which release shipped it and whether it was reverted or back-patched: status plus dated events (first post, commitfest listings, commits with branch and first release, reverts), each with its source url. kinds narrows; limit_per_kind (default 5, max 25). ~3 s budget: late parts go in timed_out. Same as GET /api/v2/related.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kinds":{"description":"Result kinds to return (default all)","items":{"enum":["mail","git","docs","wiki","commitfest","people"],"type":"string"},"type":"array"},"limit_per_kind":{"description":"Items per kind (1-25, default 5)","type":"number"},"ref":{"description":"The item: e.g. 19705-548fda77321e062d@postgresql.org, https://www.postgresql.org/docs/current/brin.html, Don't Do This, b536d5a0bd7a, CVE-2024-10979, feature:incremental backup","type":"string"},"timeline":{"description":"Include the timeline (default true)","type":"boolean"},"version":{"description":"Docs version for a page given without one (default current), e.g. 17","type":"string"}},"required":["ref"]}},{"name":"detect_changes","description":"Detect which symbols changed between two commits by comparing file content hashes.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"from_commit":{"description":"Base commit: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool.","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"},"to_commit":{"description":"Target commit: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool. Default HEAD.","type":"string"}},"required":["from_commit"]}},{"name":"discussion_links","description":"Discussion / Closes / Fixes / Backpatch-through trailers attached to one commit. Returns the raw trailer text and any URL extracted. For the messages those links resolve to, plus the committers announcement and messages citing the SHA, use git_search (mail_refs on each result).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commit_sha":{"description":"The commit: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool.","type":"string"}},"required":["commit_sha"]}},{"name":"embedding_status","description":"Get embedding coverage statistics: how many messages have embeddings, which model was used, and when embeddings were last generated.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"}},"required":[]}},{"name":"entry_branches","description":"Repository branches tracked for a commitfest entry. Joins commitfest.entry_repos with ag_repositories so callers see repo name + branch_name + is_authoritative.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"cf_id":{"description":"commitfest.postgresql.org entry id","type":"number"}},"required":["cf_id"]}},{"name":"entry_history","description":"Status changes for a commitfest entry across commitfests. The relational table doesn't carry an audit log, so we approximate the patch's lifeline by joining on shared :entry/thread-message-id (precise) and falling back to title-prefix substring (weak).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"cf_id":{"description":"commitfest.postgresql.org entry id","type":"number"}},"required":["cf_id"]}},{"name":"find_breaks","description":"Animals that failed on a branch within the time window bounded by two commit SHAs. The window is defined by the earliest started_at observed for either SHA on that branch — not by git topological order, since the buildfarm tables don't carry commit ordering.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"branch":{"description":"PG branch (e.g. master)","type":"string"},"end_sha":{"description":"Later commit SHA (window upper bound)","type":"string"},"start_sha":{"description":"Earlier commit SHA (window lower bound)","type":"string"}},"required":["branch","start_sha","end_sha"]}},{"name":"find_contributions","description":"Find raw contribution rows for one person: git commit SHAs / buildfarm animals tagged with a role + release. Useful for drill-down on a contributor's recent work.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"email":{"description":"Person's canonical email","type":"string"},"limit":{"description":"Max rows (1-500, default 50)","type":"number"},"name":{"description":"Person's name (substring; used when email is not given)","type":"string"},"release":{"description":"Restrict to one release","type":"string"},"role":{"description":"Restrict to one role","type":"string"}},"required":[]}},{"name":"find_dead_code","description":"Find functions/methods with zero incoming call graph edges (potentially unused code).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results (1-200, default 50)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"find_entries_for_author","description":"Find commitfest entries where the given person is an author. Looks up by email (exact) or by name (substring, case-sensitive).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"email":{"description":"Exact :person/email","type":"string"},"limit":{"description":"Max entries to return (1-500, default 100)","type":"number"},"name":{"description":":person/name substring (case-sensitive)","type":"string"}},"required":[]}},{"name":"find_entries_for_thread","description":"Find commitfest entries linked to a pgsql-hackers thread by Message-ID. (Returns empty until the mailing-list cross-reference scrape lands; the index attribute :entry/thread-message-id is in the schema.)","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"message_id":{"description":"RFC822 Message-ID, with or without angle brackets","type":"string"}},"required":["message_id"]}},{"name":"find_entries_with_failures_on","description":"Cross-domain feed: recent failed buildfarm runs for a named animal, plus commitfest entries with cfbot :failing rollups whose tracked branches overlap the animal's. Note: buildfarm runs commit SHAs and cfbot runs cf/<id> branches, so this verb correlates by branch overlap and time window — not by direct schema join.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"animal_name":{"description":"Buildfarm animal name (e.g. fairywren)","type":"string"},"limit":{"description":"Max recent failed runs (1-200, default 50)","type":"number"}},"required":["animal_name"]}},{"name":"find_failing_patches","description":"Commitfest entries whose latest cfbot build fails on at least one platform: cf_id, title, entry_status and commitfest_number. entry_status filters (default the active reviewable statuses, e.g. needs-review, ready-for-committer); platform narrows to one CI platform; limit caps the list. Cite https://commitfest.postgresql.org/patch/<cf_id>/.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"entry_status":{"description":"Restrict to entries in this status (e.g. needs-review, ready-for-committer). Default: any active status.","type":"string"},"limit":{"description":"Max entries (1-500, default 100)","type":"number"},"platform":{"description":"Restrict to entries failing on this platform keyword (e.g. linux, macos, windows, freebsd, netbsd, openbsd).","type":"string"}},"required":[]}},{"name":"find_failing_runs","description":"Most recent failing buildfarm runs across the entire fleet. Filterable by branch and start cutoff. Use to answer 'what is broken right now?'","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"branch":{"description":"Restrict to a single PG branch","type":"string"},"limit":{"description":"Max runs (1-1000, default 100)","type":"number"},"since":{"description":"Only runs with started_at >= this RFC3339 timestamp (default: 24h ago)","type":"string"}},"required":[]}},{"name":"find_passing_long_pending","description":"Green patches stuck in review: entries whose builds pass on every platform yet whose :entry/last-updated is older than N days. Useful for the 'why isn't this committed yet?' question.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Max entries (1-500, default 100)","type":"number"},"min_days":{"description":"Minimum days since last update (default 14)","type":"number"}},"required":[]}},{"name":"find_patches_by_platform_status","description":"Patches that pass on some platforms but not others. Example: passing on linux but failing on macos -> portability bug.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"failing_on":{"description":"Platform keyword the entry must be failing on (e.g. macos)","type":"string"},"limit":{"description":"Max entries (1-500, default 100)","type":"number"},"passing_on":{"description":"Platform keyword the entry must be passing on (e.g. linux)","type":"string"}},"required":[]}},{"name":"find_pattern","description":"Search for a regex pattern in code symbol bodies. Uses trigram indexes for acceleration.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results (1-100, default 50)","type":"number"},"pattern":{"description":"Regular expression pattern","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["pattern"]}},{"name":"find_rebase_needed_patches","description":"Entries cfbot reports as no longer applying to master tip (:entry/applies-cleanly is false). These need an author rebase.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Max entries (1-500, default 100)","type":"number"}},"required":[]}},{"name":"find_related_discussions","description":"Find mailing list messages related to a commit, topic, or PR. Searches subject and Message-ID fields via case-insensitive substring; if substring search returns no hits and an embedding provider is configured, falls back to semantic search across all inboxes.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results (1-50, default 20)","type":"number"},"query":{"description":"Search term (subject keyword, Message-ID substring, or commit hash)","type":"string"}},"required":["query"]}},{"name":"find_similar_messages","description":"Find messages similar to a given message using its embedding vector. Useful for finding related discussions or duplicate threads.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum results to return (1-50, default 10)","type":"number"},"message_id":{"description":"Message-ID of the message to find similar messages for","type":"string"}},"required":["message_id"]}},{"name":"find_string_literals","description":"Find occurrences of a literal in current (HEAD) source, restricted to a syntactic kind: \"strings\" (inside double quotes), \"comments\" (after // or /*), or \"all\".","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"description":"One of \"all\" (default), \"strings\", or \"comments\".","type":"string"},"literal":{"description":"Literal text to find. Regex metachars are escaped.","type":"string"},"max_results":{"description":"Max matches to return (1-500, default 50).","type":"number"},"repository":{"description":"Restrict results to this repository name.","type":"string"}},"required":["literal"]}},{"name":"get_animal","description":"Profile of one buildfarm animal: hardware/OS/compiler/owner, branches tracked, last build status, plus the last 20 runs (any branch).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"description":"Animal name (e.g. elasmobranch, fairywren)","type":"string"}},"required":["name"]}},{"name":"get_attachment","description":"The content of one attachment of a mail message (a patch, a log, a test case), chosen by 1-based index or a filename substring, as listed in get_message/get_thread attachments. Text attachments come back as decoded text (a .patch is ready to read or `git apply`), binary ones as base64 with encoding=base64; size is the decoded byte count. Cite the message as https://postgr.es/m/<message_id>.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"filename":{"description":"Substring to match against attachment filenames","type":"string"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"index":{"description":"1-based attachment index (from get_message attachment metadata)","type":"number"},"message_id":{"description":"Message-ID (with or without angle brackets)","type":"string"}},"required":["message_id"]}},{"name":"get_author_messages","description":"Find messages by a specific author, optionally filtered by date range. Uses the f: (from) search prefix.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"after":{"description":"Only return messages after this date (YYYY-MM-DD or YYYYMMDD)","type":"string"},"author":{"description":"Author name or email to search for","type":"string"},"before":{"description":"Only return messages before this date (YYYY-MM-DD or YYYYMMDD)","type":"string"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum results to return (1-200, default 50)","type":"number"},"offset":{"description":"Offset for pagination","type":"number"}},"required":["author"]}},{"name":"get_callees","description":"Find all symbols that the given symbol calls/references (forward call graph).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results (1-100, default 50)","type":"number"},"qualified_name":{"description":"Fully qualified symbol name","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"get_callers","description":"Reverse call graph: the symbols that call or reference qualified_name (from search_symbols), each with its file and lines, like `git grep -w <name>` restricted to call sites. HEAD only; macro expansion and function pointers are not followed. limit caps the list. Read a caller with git_show_file at its line.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results (1-100, default 50)","type":"number"},"qualified_name":{"description":"Fully qualified symbol name","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"get_commit","description":"One postgres commit from the code-history index: message, parsed trailers (names only), Discussion threads (links to the archived thread on /m/), back-patch siblings on other branches, first_releases (per branch the change landed on: sha, release such as 14.23, first_version incl. betas, shipped=false when reverted before that release; null release = not yet released), reverted_by and reverts, files changed with line counts, and its diff rendered from the index (at most 3000 lines; diff_complete says whether it was cut). Accepts a SHA (7+ hex), branch, tag or any version form.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commit":{"description":"SHA or prefix (7+ hex), or any version form (REL_17_0, master~2)","type":"string"},"context":{"description":"Diff context lines (0-1000, default 3)","type":"number"},"diff":{"description":"Include the diff (default true)","type":"boolean"},"paths":{"description":"Only diff files under these paths","items":{"type":"string"},"type":"array"},"repository":{"description":"Repository; only postgres is in the code-history index for now (the default).","type":"string"}},"required":["commit"]}},{"name":"get_commitfest","description":"Get a single commitfest with entries grouped by status and the top contributors (authors with the most entries).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"number":{"description":"Commitfest sequence number, e.g. 59","type":"number"}},"required":["number"]}},{"name":"get_communities","description":"List Louvain community clusters detected in the call graph. Communities group related symbols by functional area.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum communities (1-100, default 20)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"get_community","description":"Get details and member symbols for a specific community.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"community_id":{"description":"Community ID","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["community_id"]}},{"name":"get_contributor","description":"A contributor's profile by email (exact) or name (substring): canonical name, page hash, totals and per-release counts by role (authored, reviewed, committed, reported, ...), the 5 latest credited commits with sha, and buildfarm animals they own. People who hid their page are excluded from name lookups. For what they did recently use whats_new. Cite https://pg.ddx.io/community/<hash>.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"email":{"description":"Exact :person/canonical-email match","type":"string"},"name":{"description":":person/canonical-name substring (case-insensitive). Used only when email is not provided.","type":"string"}},"required":[]}},{"name":"get_contributor_history","description":"Show all past mailing list submissions by a contributor (matched by email address or name).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"contributor":{"description":"Contributor email address or display name","type":"string"},"limit":{"description":"Maximum results (1-100, default 50)","type":"number"}},"required":["contributor"]}},{"name":"get_dependents","description":"Get transitive dependents: all symbols in the blast radius if this symbol changes.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results (1-200, default 50)","type":"number"},"max_depth":{"description":"Maximum BFS depth (1-5, default 3)","type":"number"},"qualified_name":{"description":"Fully qualified symbol name","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"get_doc_page","description":"One PostgreSQL documentation page as text: path (e.g. \"brin.html\" or \"sql-createtable.html\") and optional version (\"17\", \"current\"; default the latest). Returns its url, path and stored text (body) with fetched_at. Use search_docs to find the path. Cite the returned url.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"path":{"description":"URL path of the documentation page","type":"string"},"version":{"description":"Documentation version (default: latest available)","type":"string"}},"required":["path"]}},{"name":"get_entry","description":"One commitfest entry by cf_id (the number in commitfest.postgresql.org/patch/<cf_id>/): title, status, commitfest, authors, reviewers, committer, its mail threads and branches. Read the thread with get_thread; cfbot state with find_failing_patches. Cite https://commitfest.postgresql.org/patch/<cf_id>/.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"cf_id":{"description":"commitfest.postgresql.org entry id","type":"number"}},"required":["cf_id"]}},{"name":"get_execution_flows","description":"Trace execution flow paths through the call graph from entry points.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"max_depth":{"description":"Maximum BFS depth (1-10, default 8)","type":"number"},"max_flows":{"description":"Maximum flows to return (1-50, default 20)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"get_impact","description":"Analyze the impact of modifying a symbol: risk level, blast radius, affected communities and execution flows.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"qualified_name":{"description":"Fully qualified symbol name","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"get_inbox_info","description":"Get metadata for an inbox (name, addresses, message count, last activity)","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"}},"required":[]}},{"name":"get_inbox_stats","description":"Return aggregate statistics about an inbox: message counts by time period, top authors, and activity trends.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"period":{"description":"Aggregation period: \"day\", \"week\", \"month\" (default), or \"year\"","type":"string"},"top_authors":{"description":"Number of top authors to return (1-50, default 10)","type":"number"}},"required":[]}},{"name":"get_inbox_summary","description":"Per-inbox summary: total messages, top 10 posters, thread count, date range, and lifetime average messages/day (total messages divided by the days spanned by the archive).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"description":"Inbox name","type":"string"}},"required":["name"]}},{"name":"get_message","description":"One mail message by Message-ID: headers, in_reply_to/references, decoded body text (by default the author's own words: quotes, signature and inline patch removed; full_text=true for everything, quotes included), attachments [{index, filename, content_type, size}] and has_patch. Never raw MIME: get_attachment returns an attachment's content, get_raw_message the RFC 822 source. Finds the list itself unless inbox is given. Cite as https://postgr.es/m/<message_id>.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"body_only":{"description":"Older spelling of full_text=true: the whole decoded text (default false).","type":"boolean"},"full_text":{"description":"Return the whole decoded text, quoted replies and signature included (default false: the author's own words only).","type":"boolean"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"include_body":{"description":"Include message body (default true)","type":"boolean"},"message_id":{"description":"Message-ID (with or without angle brackets)","type":"string"}},"required":["message_id"]}},{"name":"get_message_headers","description":"Get email headers as structured key/value pairs. Returns all headers or a specific header by name.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"header":{"description":"Specific header name to retrieve (e.g. \"X-Mailer\"); omit to get all headers","type":"string"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"message_id":{"description":"Message-ID (with or without angle brackets)","type":"string"}},"required":["message_id"]}},{"name":"get_message_references","description":"Discover cross-references in a message. Returns explicit References/In-Reply-To headers plus any Message-IDs found in the body text, with archive lookup for each.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"message_id":{"description":"Message-ID (with or without angle brackets)","type":"string"}},"required":["message_id"]}},{"name":"get_new_messages","description":"Return messages newer than a given article number cursor, enabling agents to poll for new messages without re-scanning. Use after=0 for the first call, then use the returned last_article_num as the cursor for subsequent calls.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"after":{"description":"Article number cursor; returns messages with article numbers greater than this value. Use 0 for the first call.","type":"number"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum messages to return (1-1000, default 200)","type":"number"}},"required":["after"]}},{"name":"get_patch_branches","description":"Get the git branches created from a patch series. Shows what branches were applied from email patches for code intelligence analysis.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"pr_url":{"description":"Forge pull request URL","type":"string"}},"required":["pr_url"]}},{"name":"get_patch_build_history","description":"Build matrix for one entry: per-platform/config status, log URL, observation time, applies-cleanly flag, rollup.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"cf_id":{"description":"commitfest.postgresql.org entry id","type":"number"}},"required":["cf_id"]}},{"name":"get_patch_series","description":"Get patch submission history for a forge pull request URL. Returns all iterations submitted to the mailing list.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"pr_url":{"description":"Forge pull request URL","type":"string"}},"required":["pr_url"]}},{"name":"get_raw_message","description":"Get the complete raw RFC 822 email bytes for a message. Useful for agents that need to parse headers/structure themselves or forward messages.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"message_id":{"description":"Message-ID (with or without angle brackets)","type":"string"}},"required":["message_id"]}},{"name":"get_repo_sync_stats","description":"Get commit frequency analysis and sync statistics for a repository. Returns median commit interval, recommended poll frequency, and recent fetch log.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"get_repository_summary","description":"Per-repository summary: total commits, top 10 contributors, branches, language breakdown (from indexed symbols), and a sampled most-touched-paths list.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"description":"Repository name","type":"string"}},"required":["name"]}},{"name":"get_signature","description":"Get the function/method signature and doc comment for a symbol.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"qualified_name":{"description":"Fully qualified symbol name","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"get_source_info","description":"Detail for a single source by name. Returns kind, item_count, last_update, next_sync, freshness_status, and description.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"description":"Source name (inbox name, repo name, source nick)","type":"string"}},"required":["name"]}},{"name":"get_symbol","description":"Get full details for a code symbol by its qualified name, including source code, signature, documentation, and file location.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"qualified_name":{"description":"Fully qualified symbol name (e.g. 'MyClass.myMethod', 'pkg::func_name')","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"get_tests_for","description":"Find test symbols that reference the given symbol.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"qualified_name":{"description":"Fully qualified symbol name","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["qualified_name"]}},{"name":"get_thread","description":"A mail thread, found by any Message-ID in it, oldest first. Each message: from, to, cc, date, message_id, decoded body text (by default the author's own words: quoted replies, signature and inline patch removed; full_text=true for the whole decoded text; never raw MIME), attachments [{index, filename, content_type, size}] and has_patch. Paged: 20 messages per call (limit max 500; offset/next_offset/has_more); bodies capped at max_body_chars (default 4000; 0 = no cap; body_truncated marks a cut). include_bodies=false gives a cheap outline. Finds the list itself unless inbox is given. Cite as https://postgr.es/m/<message_id>.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"full_text":{"description":"Whole decoded text of each message, quotes included (default false: own words only).","type":"boolean"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"include_bodies":{"description":"Include message bodies (default true). false returns an outline: headers only.","type":"boolean"},"limit":{"description":"Messages per page (1-500, default 20).","type":"number"},"max_body_chars":{"description":"Cap each body at this many characters (default 4000; 0 = no cap).","type":"number"},"message_id":{"description":"Message-ID of any message in the thread","type":"string"},"offset":{"description":"Skip this many messages; use next_offset from the previous page.","type":"number"}},"required":["message_id"]}},{"name":"get_thread_references","description":"Cross-reference graph for an entire thread. Collects all Message-IDs referenced in body text across all messages in the thread and resolves which other threads they point to.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"message_id":{"description":"Message-ID of any message in the thread","type":"string"}},"required":["message_id"]}},{"name":"get_wiki_history","description":"Get revision history for a wiki page.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum revisions to return (1-100, default 20)","type":"number"},"title":{"description":"Wiki page title","type":"string"}},"required":["title"]}},{"name":"get_wiki_page","description":"One wiki.postgresql.org page by title: its latest revision content with author and date. Titles are as on the wiki (\"Don't Do This\", \"Todo\"). Use search_wiki to find a title, get_wiki_history for older revisions. Cite https://wiki.postgresql.org/wiki/<title>.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"title":{"description":"Wiki page title","type":"string"}},"required":["title"]}},{"name":"git_analyze_activity","description":"Show commit activity over time, bucketed by period. Useful for understanding development pace and trends.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"period":{"description":"Aggregation period: \"week\", \"month\" (default), \"quarter\", or \"year\"","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"git_analyze_authors","description":"Get commit statistics per author: total commits, first and last commit dates. Ranked by commit count.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum authors to return (1-100, default 25)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"git_analyze_bus_factor","description":"Identify files with the fewest distinct authors (bus factor risk). Files modified by only one person are knowledge silos.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum files to return (1-100, default 25)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"git_analyze_churn","description":"Identify the most frequently modified files in the repository. High-churn files may indicate hotspots or unstable code.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results to return (1-100, default 25)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"git_analyze_coupling","description":"Find files that are frequently changed together. Logical coupling can reveal hidden dependencies between components.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum pairs to return (1-100, default 25)","type":"number"},"min_count":{"description":"Minimum co-change count to include a pair (default 2)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"git_analyze_hotspots","description":"Aggregate file churn by directory to find the most actively changed areas of the codebase.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"depth":{"description":"Directory depth for aggregation (default 1)","type":"number"},"limit":{"description":"Maximum directories to return (1-100, default 25)","type":"number"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"git_blame","description":"File version history, not a per-line blame: the commits that changed a file on the history of a commit (like `git log <rev> -- <path>`), newest first, each with sha, commit_id, author, date, summary and status (added/modified/deleted). Renames are not followed. Up to `limit` commits (default 100, max 1000); has_more says there are older ones.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commit":{"description":"List the commits on the history of this commit: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool. Default HEAD.","type":"string"},"limit":{"description":"Maximum commits to return (1-1000, default 100).","type":"number"},"path":{"description":"File path within the repository","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["path"]}},{"name":"git_diff","description":"Two modes: (1) commit-range mode — pass base_branch and head_branch to get the list of commits unique to head_branch (set difference base..head), optionally filtered by author/message/path; (2) content-diff mode — pass from_commit and to_commit to compute file-level unified diffs between two specific commits.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"author":{"description":"Commit-range mode: filter by author name or email (substring match)","type":"string"},"base_branch":{"description":"Commit-range mode: base side of the range (excluded). Defaults to the repository's default branch when head_branch is set.","type":"string"},"from_commit":{"description":"Content-diff mode: commit to diff from: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool.","type":"string"},"head_branch":{"description":"Commit-range mode: head side of the range (included). When set, switches to commit-range mode.","type":"string"},"limit":{"description":"Commit-range mode: maximum commits to return (1-1000, default 100)","type":"number"},"message_filter":{"description":"Commit-range mode: filter commits whose message matches this string (case-insensitive substring; passed to git log --grep)","type":"string"},"path":{"description":"Limit results to a specific file path","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"},"to_commit":{"description":"Content-diff mode: commit to diff to: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool. Default HEAD.","type":"string"}},"required":[]}},{"name":"git_log","description":"Commit history like `git log`, newest first, filtered by path (commits touching a file), author (substring), since/until (YYYY-MM-DD or RFC 3339) and branch (any branch, tag or major version such as 17 or 9.6; default the indexed default branch). Each commit: sha (40-hex, cite it), commit_id, message (subject for a branch log), author and dates. limit default 50, max 200; offset pages; has_more. repository defaults to postgres.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"author":{"description":"Filter by author name or email (substring match)","type":"string"},"branch":{"description":"Restrict the log to commits reachable from this branch (e.g. cf/5556). Default: the repository's default branch.","type":"string"},"limit":{"description":"Maximum commits to return (1-200, default 50)","type":"number"},"offset":{"description":"Offset for pagination (default 0)","type":"number"},"path":{"description":"Filter commits to those touching this file path","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"},"since":{"description":"Only commits after this date (YYYY-MM-DD or RFC3339)","type":"string"},"until":{"description":"Only commits before this date (YYYY-MM-DD or RFC3339)","type":"string"}},"required":[]}},{"name":"git_search","description":"Search postgres commit messages (or file paths with search_in=paths) by keywords, newest first (all words must appear, case-insensitive; like `git log -i --grep` with every word). Each commit: sha (40-hex, cite it), commit_id, message, author, date, people credited, and mail_refs: up to 5 messages that refer to it {inbox, message_id, subject, url, how_it_refers: discussion-trailer, committers-announcement or mentions-hash}. repository defaults to postgres; limit default 50, max 200. Details with commit_history.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results to return (1-200, default 50)","type":"number"},"query":{"description":"Search query string","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"},"search_in":{"description":"What to search: \"messages\" (commit messages, default) or \"paths\" (file paths)","type":"string"}},"required":["query"]}},{"name":"git_show_file","description":"Read a file at any commit, branch, tag or major version (like `git show <rev>:<path>`), from the git clone. commit takes a SHA (>= 7 hex), branch, tag, 17 or 9.6, <ref>~N or a commit_id; default HEAD; an unknown name or path is an error, never a silent HEAD. Returns at most 2000 lines per call: start_line/end_line pick the range, total_lines gives the length and cut=true says more follow. Lines are numbered with a tab (numbered=false gives the exact bytes). Each result has sha (cite it with the path and lines) and ref. Binary files return a note instead of content.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commit":{"description":"Commit to read the file at: a SHA (>= 7 hex), branch, tag, major version (17, 9.6), <ref>~N, or a commit_id from another tool. Default HEAD. An unknown name is an error, never a silent HEAD.","type":"string"},"end_line":{"description":"Last line to return (1-based, inclusive). Default: the end of the file, capped at start_line + 1999.","type":"number"},"numbered":{"description":"Prefix each line with its line number and a tab (default true). false returns the exact file bytes.","type":"boolean"},"path":{"description":"File path within the repository","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"},"start_line":{"description":"First line to return (1-based). Default 1.","type":"number"}},"required":["path"]}},{"name":"grep_repository","description":"Literal-text search of the CURRENT source only (HEAD of master for postgres, the default branch elsewhere), like `git grep -F` (regex characters are escaped; case_insensitive=true for -i). Returns up to max_results files (default 50, max 500), each with repo_name, file_path, line_no and snippet (its first matching line). For any other commit, branch, tag, major version or date, for every match with context, or to search history, use code_search (version=, history=). Read a hit with read_file or git_show_file; cite path:line with the sha.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"case_insensitive":{"description":"Match case-insensitively (default false).","type":"boolean"},"max_results":{"description":"Max matches to return (1-500, default 50).","type":"number"},"repository":{"description":"Restrict results to this repository name.","type":"string"},"text":{"description":"Literal substring to search for. Regex metachars are escaped before searching.","type":"string"}},"required":["text"]}},{"name":"history-of","description":"One-shot historical context for CI: given content (a diff, file path, symbol, commit subject, or feature name), return the most relevant default-branch commits, the associated mailing-list discussion (message links), and the tracked people involved (community page links). Read-only; composes git history + list search.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"content":{"description":"Free text: a diff/hunk, file path(s), symbol name, commit subject, feature name, or error text.","type":"string"},"inbox":{"description":"Mailing list to search for discussion (default: pgsql-hackers).","type":"string"},"limit":{"description":"Max items per section (default 5).","type":"number"},"repo":{"description":"Tracked repo whose default branch to trace (default: postgres).","type":"string"}},"required":["content"]}},{"name":"hybrid_search","description":"Mailing-list search, keyword (BM25 over the authors' own words) and semantic (embeddings) blended per thread, over every list unless inbox names one or more. Returns up to limit threads (default 20, max 50), best first, each its best message: inbox, message_id, subject, from, date, thread_id, fused_score (0-1), similarity and a short excerpt of the author's own words. Like a ranked `git log --grep` for mail. Cite as https://postgr.es/m/<message_id>; read with get_thread or get_message (inbox from the result). author, since and until restrict both arms to one sender and a date window.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"author":{"description":"Only messages this person sent: a name, an e-mail address or hash:<8 hex> (a person page). Resolved to every address they post from; an ambiguous name returns the candidates to choose from.","type":"string"},"inbox":{"description":"Lists to search: omit (or \"all\") for every list, the default; one name such as pgsql-bugs; or several, comma-separated (\"pgsql-hackers,pgsql-bugs\"). Names from list_inboxes. Aliases: list, inbox_name.","type":"string"},"keyword_weight":{"description":"Weight for keyword results in the fusion, 0.0-1.0 (default 0.65). Raise it for exact identifiers (function names, GUCs, error text); lower it to lean on semantic similarity.","type":"number"},"limit":{"description":"Maximum results to return (1-50, default 20)","type":"number"},"query":{"description":"Search query (supports both keywords and natural language). Operators: after:/before:YYYY[-MM[-DD]], d:A..B, site:<list|docs|wiki|commits>, from:/author:, intitle:/s:, intext:/b:, to:/cc:, filetype:patch, has:patch, link:<url glob> (messages linking to a URL; link:example.org = any URL on that host), /regex/ (case:yes for case-sensitive), -operator to negate. Operators without words list matches newest first.","type":"string"},"since":{"description":"Only messages sent on or after this date (UTC): YYYY, YYYY-MM, YYYY-MM-DD, an ISO date-time, or 2w / 6m / 1y ago.","type":"string"},"until":{"description":"Only messages sent before this date (exclusive), same forms as since. With author: what that person had said by then.","type":"string"}},"required":["query"]}},{"name":"hybrid_search_code","description":"Combined keyword + semantic code search using Reciprocal Rank Fusion. Requires embeddings to be generated.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"keyword_weight":{"description":"Weight for keyword results in fusion (0.0-1.0, default 0.5)","type":"number"},"limit":{"description":"Maximum results (1-100, default 20)","type":"number"},"query":{"description":"Search query (supports keywords and natural language)","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["query"]}},{"name":"list_animals","description":"List PostgreSQL buildfarm animals. Filterable by OS, branch tracked, last build status, or owner. Failing animals are returned first (sort key: last_status='failed' DESC, name ASC).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"branch":{"description":"Restrict to animals tracking this PostgreSQL branch (e.g. master, REL_18_STABLE)","type":"string"},"limit":{"description":"Max animals (1-500, default 100)","type":"number"},"os":{"description":"Restrict to animals running this OS (exact match against ag_buildfarm_animals.os)","type":"string"},"owner":{"description":"Restrict to a single owner_name or owner_email (exact match)","type":"string"},"status":{"description":"Restrict to animals with this last_status: passed, failed, flapping, unknown","type":"string"}},"required":[]}},{"name":"list_branches","description":"List tracked branches for a repository, including head commit and default branch status.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"list_commitfests","description":"List PostgreSQL commitfests indexed in the mentat triple store. Each commitfest carries a status (:open / :in-progress / :closed) and an entry count grouped by status.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"status":{"description":"Filter by commitfest status: open, in-progress, or closed","type":"string"}},"required":[]}},{"name":"list_contributors","description":"List PostgreSQL community contributors aggregated across git trailers (Reviewed-by, Tested-by, etc.), commit author/committer headers, and buildfarm animal owners. Sorted by total contributions descending. Filterable by release / role / source.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Max contributors to return (1-500, default 100)","type":"number"},"offset":{"description":"Pagination offset (default 0)","type":"number"},"release":{"description":"Restrict to one release tag, e.g. PG18 / PG17 / pre-9.6","type":"string"},"role":{"description":"Restrict to one role: authored, reviewed, tested, reported, committed, co-authored, suggested, signed-off, buildfarm-owner, ...","type":"string"},"source":{"description":"Restrict to one source: git, buildfarm, email, wiki, commitfest","type":"string"}},"required":[]}},{"name":"list_discord_channels","description":"List monitored Discord channels with message counts.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"required":[]}},{"name":"list_doc_versions","description":"List available documentation versions with page counts.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"required":[]}},{"name":"list_entries","description":"List commitfest entries (proposed patch series). Filterable by status, commitfest number, or topic; paginated.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commitfest_number":{"description":"Restrict to entries from this commitfest (e.g. 59)","type":"number"},"limit":{"description":"Max entries to return (1-500, default 100)","type":"number"},"offset":{"description":"Pagination offset (default 0)","type":"number"},"status":{"description":"Status keyword without leading colon, e.g. needs-review, ready-for-committer, waiting-on-author, committed, withdrawn, returned-with-feedback","type":"string"},"topic":{"description":"Restrict to entries with this :entry/topic value (substring match)","type":"string"}},"required":[]}},{"name":"list_files","description":"List the files of the postgres source under a directory at any commit, branch, tag or date (code-history index), with line counts; depth folds deeper paths into directories with file counts; glob filters paths.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"depth":{"description":"Levels below path to list (default all)","type":"number"},"glob":{"description":"Path glob, e.g. *.dat or src/include/catalog/*.h","type":"string"},"limit":{"description":"Entries (1-5000, default 500)","type":"number"},"path":{"description":"Directory (default the root)","type":"string"},"repository":{"description":"Repository; only postgres is in the code-history index for now (the default).","type":"string"},"version":{"description":"Commit to read: a SHA or 7+ hex prefix, a branch (master, REL_17_STABLE), a tag (REL_17_0), a major (17, 9.6), a release (17.2), <ref>@YYYY-MM-DD (the branch's last commit by that day), or <ref>~N. Default: the newest release branch's head.","type":"string"}}}},{"name":"list_inboxes","description":"List all configured agora mailboxes with name, message_count, latest_message_date, latest_import_date, listid (when known) and description. Optional min_messages filter; limit/offset are accepted for forward compatibility.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Forward-compat: max rows (default unlimited)","type":"number"},"min_messages":{"description":"Only return inboxes with at least this many messages","type":"number"},"offset":{"description":"Forward-compat: skip the first N rows","type":"number"}},"required":[]}},{"name":"list_projects","description":"List bridge-configured projects linking a forge repository to a mailing list inbox.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"required":[]}},{"name":"list_recent","description":"List recent messages from an inbox","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum messages to return (1-200, default 25)","type":"number"}},"required":[]}},{"name":"list_repositories","description":"List all registered git repositories with name, branch, commit_count, file_count, indexed-symbol_count, latest_commit, last_fetched_at, and import_state. Optional min_commits and branch filters; limit/offset accepted for forward compatibility.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"branch":{"description":"Filter to repositories whose default branch matches this string","type":"string"},"limit":{"description":"Forward-compat: max rows (default unlimited)","type":"number"},"min_commits":{"description":"Only return repositories with at least this many commits","type":"number"},"offset":{"description":"Forward-compat: skip the first N rows","type":"number"}},"required":[]}},{"name":"list_sources","description":"Every source behind this server with its kind (inbox, repository, docs, wiki, discord), item count, last update and freshness (fresh/stale): the 56 mailing lists, the git repositories, the documentation releases, the wiki and Discord. Use it to learn the inbox and repository names other tools accept and how current each is. kind filters; min_items drops small sources.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"description":"Filter to a single kind (inbox|repository|docs|wiki|discord)","type":"string"},"limit":{"description":"Forward-compat: max rows (default unlimited)","type":"number"},"min_items":{"description":"Only return sources with at least this many items","type":"number"},"offset":{"description":"Forward-compat: skip the first N rows","type":"number"}},"required":[]}},{"name":"list_threads","description":"Browse recent threads (topic-level view). Returns thread summaries with message counts, date ranges, and latest message metadata.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"before":{"description":"Unix timestamp; only return threads with last activity before this time (for pagination)","type":"number"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum threads to return (1-100, default 20)","type":"number"}},"required":[]}},{"name":"read_file","description":"Read a file of the postgres source at any commit, branch, tag or date from the code-history index: numbered lines, at most 2000 per call (page with start_line/end_line), byte-exact to git. Says total_lines and complete; binary files return their metadata only.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"end_line":{"description":"Last line (default start_line + 1999)","type":"number"},"path":{"description":"Path from the repository root, e.g. src/backend/access/transam/xlog.c","type":"string"},"repository":{"description":"Repository; only postgres is in the code-history index for now (the default).","type":"string"},"start_line":{"description":"First line (default 1)","type":"number"},"version":{"description":"Commit to read: a SHA or 7+ hex prefix, a branch (master, REL_17_STABLE), a tag (REL_17_0), a major (17, 9.6), a release (17.2), <ref>@YYYY-MM-DD (the branch's last commit by that day), or <ref>~N. Default: the newest release branch's head.","type":"string"}},"required":["path"]}},{"name":"recent_commitfest_activity","description":"Rolling window of commitfest entries updated in the last N days. Returns the entries plus a status histogram. Uses the relational commitfest.entries table for predictable latency.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Max entries (1-500, default 100)","type":"number"},"since":{"description":"RFC3339 cutoff (default: 7 days ago)","type":"string"}},"required":[]}},{"name":"regex_search_code","description":"Regular-expression search of the CURRENT source only (HEAD of master for postgres, the default branch elsewhere), like `git grep -E` with grep's line semantics: ^ and $ anchor at line starts and ends, . does not cross lines. PostgreSQL regex syntax (\\s, \\w, (?i) work). path_glob narrows by SQL LIKE pattern (\"src/backend/%.c\"), repository by name. Returns up to max_results files (default 50, max 500) with repo_name, file_path, line_no and snippet (its first matching line). For any other commit, branch, tag, major version or date, all matches with context, or history, use code_search with match=regex. Cite path:line with the sha.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"max_results":{"description":"Max matches to return (1-500, default 50).","type":"number"},"path_glob":{"description":"Restrict results to paths matching this SQL LIKE pattern, e.g. \"%/src/backend/%.c\".","type":"string"},"pattern":{"description":"POSIX extended regex pattern, e.g. \"^static\\\\s+void\\\\s+ProcSignal\".","type":"string"},"repository":{"description":"Restrict results to this repository name (exact match against ag_repositories.name).","type":"string"}},"required":["pattern"]}},{"name":"release_contributors","description":"Top contributors per role for one release. Scope: canonical authoritative repos only (ag_repositories.is_authoritative = TRUE). Returns top 20 per role across authored / reviewed / tested / reported / committed (per-role distinct-commit counts).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"per_role_limit":{"description":"Top-N per role (1-100, default 20)","type":"number"},"release":{"description":"Release tag, e.g. PG18 / PG17 / pre-9.6","type":"string"}},"required":["release"]}},{"name":"repository_stats","description":"Get detailed statistics for a git repository including commit count, file count, branch, and import state.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":[]}},{"name":"retrieve_context","description":"START HERE for a question about PostgreSQL. Searches every mailing list (inbox narrows it) with hybrid keyword + semantic ranking and returns cited passages that fit token_budget (default 4000, max 32000): one passage per thread, each the author's own words (quotes, signature and patch removed, cut at ~1200 chars) with url, inbox, message_id, from and date. found=false with a reason when the archive does not appear to discuss the question, instead of weak matches. Retrieval only: write the answer yourself. Cite each claim with its passage url or https://postgr.es/m/<message_id>; open a thread with get_thread. author, since and until restrict it to what one person wrote in a date window (filter echoes them).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"author":{"description":"Only messages this person sent: a name, an e-mail address or hash:<8 hex> (a person page). Resolved to every address they post from; an ambiguous name returns the candidates to choose from.","type":"string"},"inbox":{"description":"Lists to search: omit (or \"all\") for every list, the default; one name such as pgsql-bugs; or several, comma-separated (\"pgsql-hackers,pgsql-bugs\"). Names from list_inboxes. Aliases: list, inbox_name.","type":"string"},"question":{"description":"The question, in plain language.","type":"string"},"since":{"description":"Only messages sent on or after this date (UTC): YYYY, YYYY-MM, YYYY-MM-DD, an ISO date-time, or 2w / 6m / 1y ago.","type":"string"},"token_budget":{"description":"Maximum tokens of evidence to return (default 4000, max 32000).","type":"number"},"until":{"description":"Only messages sent before this date (exclusive), same forms as since. With author: what that person had said by then.","type":"string"}},"required":["question"]}},{"name":"search","description":"Keyword search of mailing-list messages (BM25 over subject, sender and the authors' own words), every list unless inbox narrows it. Operators in query: s:/intitle: subject, f:/from: sender, b:/intext: body, after:/before:/d:2024-01..2025-01 dates, site:<list>, filetype:patch, link:<url glob>, /regex/. Returns messages best first (limit default 50, max 200; offset pages; collapse_threads=true keeps one per thread), each with inbox, message_id, subject, from, date, thread_id and an excerpt, plus total and has_more. Use it for exact words, names and identifiers; hybrid_search for questions. Cite as https://postgr.es/m/<message_id>. author, since and until restrict it to one sender and a date window.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"author":{"description":"Only messages this person sent: a name, an e-mail address or hash:<8 hex> (a person page). Resolved to every address they post from; an ambiguous name returns the candidates to choose from.","type":"string"},"collapse_threads":{"description":"Deduplicate results to one per thread, keeping the highest-scoring hit (default false)","type":"boolean"},"inbox":{"description":"Lists to search: omit (or \"all\") for every list, the default; one name such as pgsql-bugs; or several, comma-separated (\"pgsql-hackers,pgsql-bugs\"). Names from list_inboxes. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum results to return (1-200, default 50)","type":"number"},"offset":{"description":"Offset for pagination","type":"number"},"query":{"description":"Search query string. Operators: after:/before:YYYY[-MM[-DD]], d:A..B, site:<list|docs|wiki|commits>, from:/author:, intitle:/s:, intext:/b:, to:/cc:, filetype:patch, has:patch, link:<url glob> (messages linking to a URL; link:example.org = any URL on that host), /regex/ (case:yes for case-sensitive), -operator to negate. Operators without words list matches newest first.","type":"string"},"since":{"description":"Only messages sent on or after this date (UTC): YYYY, YYYY-MM, YYYY-MM-DD, an ISO date-time, or 2w / 6m / 1y ago.","type":"string"},"until":{"description":"Only messages sent before this date (exclusive), same forms as since. With author: what that person had said by then.","type":"string"}},"required":["query"]}},{"name":"search-regex","description":"Full-text search across mailing list messages using POSIX regex patterns. Supports edit-distance fuzzy matching via the `k` parameter (0 = exact regex, >=1 = up to k insertions/deletions/substitutions per match). Same prefix syntax as `search`: s:subject f:from t:to d:2024-01..2025-01 b:body_text","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"collapse_threads":{"description":"Deduplicate results to one per thread (default false)","type":"boolean"},"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"k":{"description":"Edit distance for fuzzy match (0-5, default 0)","type":"number"},"limit":{"description":"Maximum results to return (1-200, default 50)","type":"number"},"offset":{"description":"Offset for pagination","type":"number"},"query":{"description":"POSIX regex pattern","type":"string"}},"required":["query"]}},{"name":"search_all_sources","description":"Unified search across all document sources (docs, wiki, and email). Returns results ranked by relevance.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results to return (1-50, default 20)","type":"number"},"query":{"description":"Search query (supports both keywords and natural language). Operators apply to every source they fit: after:/before:, site:docs|wiki|mail|commits, intitle:, from:, link:<url glob>, /regex/ (see GET /api/v2/links and the /search page's syntax help).","type":"string"}},"required":["query"]}},{"name":"search_commitfest","description":"Full-text search of commitfest entries (title first, then author/reviewer/committer names), in the current commitfest by default, or commitfests=\"all\" (back to 2014) or a comma list of numbers. Websearch syntax: \"phrase\", -term, or. Each result: cf_id, title, status, commitfest(s), people, last update, the commitfest.postgresql.org patch url and the pg.ddx.io thread link. limit default 20, max 50. Details with get_entry; cite the patch url.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"commitfests":{"description":"\"current\" (default: the commitfest commitfest.postgresql.org/current/ shows), \"all\", or a comma list of commitfest numbers, e.g. \"62,61\" or \"current,55\"; see /api/v2/commitfest/commitfests","type":"string"},"limit":{"description":"Max results (default 20, max 50)","type":"integer"},"query":{"description":"Search query, e.g. NUMA or \"Tom Lane\"","type":"string"}},"required":["query"]}},{"name":"search_commits","description":"Search postgres commits (code-history index), newest first, like git log: range (a rev, or A..B; default the newest release branch), message (regex, case-insensitive), author (regex over author, committer and Author/Co-authored-by/Reviewed-by trailers), paths, since/until (YYYY-MM-DD), changed_lines (a regex an added or removed line matches, as git log -G) and occurrences (a string whose count in a file changed, as git log -S).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"author":{"description":"Regex over author, committer and credit trailers","type":"string"},"budget_ms":{"description":"Time budget (100-15000, default 10000)","type":"number"},"changed_lines":{"description":"Regex an added or removed line matches (git log -G)","type":"string"},"limit":{"description":"Commits (1-200, default 30)","type":"number"},"message":{"description":"Regex over the commit message","type":"string"},"occurrences":{"description":"String whose number of occurrences changed (git log -S)","type":"string"},"offset":{"description":"Commits to skip","type":"number"},"paths":{"description":"Path prefixes the commit touched","items":{"type":"string"},"type":"array"},"range":{"description":"A rev (its line back to the root) or A..B; default the newest release branch","type":"string"},"repository":{"description":"Repository; only postgres is in the code-history index for now (the default).","type":"string"},"since":{"description":"YYYY-MM-DD (committed on or after)","type":"string"},"until":{"description":"YYYY-MM-DD (committed before)","type":"string"}}}},{"name":"search_discord_topics","description":"Find PostgreSQL Discord discussions semantically related to a query. Returns only the channel, approximate date range, and participants of relevant conversations — never message content or links (per the Discord community agreement).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results to return (1-25, default 10)","type":"number"},"query":{"description":"Natural language query to find semantically related Discord discussions","type":"string"}},"required":["query"]}},{"name":"search_docs","description":"Full-text search of the PostgreSQL documentation (websearch syntax: \"phrase\", -term, or), title matches first. Searches the current release unless version (one, e.g. \"17\") or versions (several) is given; a page matching in several selected versions is one result listing each version and its URL. Returns title, path, url, the versions it matched and a snippet. Read a page with get_doc_page; cite its postgresql.org/docs url.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results to return (1-50, default 20)","type":"number"},"query":{"description":"Search query string","type":"string"},"version":{"description":"One documentation version (e.g. \"18\", \"17\"; \"current\" = the current release). Ignored when versions is given.","type":"string"},"versions":{"description":"Documentation versions to search, e.g. [\"18\", \"17\"] (default: the current release; see list_doc_versions)","items":{"type":"string"},"type":"array"}},"required":["query"]}},{"name":"search_patches","description":"Find patch series by parsing [PATCH v2 3/7]-style subject prefixes. Returns structured patch metadata including version, sequence, total, and series grouping.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Mailing list name, e.g. pgsql-general. Defaults to pgsql-hackers when omitted. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum results to return (1-100, default 50)","type":"number"},"query":{"description":"Additional search query to filter patches","type":"string"}},"required":[]}},{"name":"search_symbols","description":"Find C functions, macros, types and variables by name in the indexed source (HEAD): BM25 on names, then fuzzy and body matches. Filter by kind (function, struct, macro, ...), language, repository. Each result: qualified_name, name, kind, language, file, start_line and end_line. Like `ctags`/`git grep -w` for definitions. Follow with get_callers, or git_show_file with start_line/end_line to read the body.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"description":"Filter by symbol kind: function, class, method, struct, enum, interface, trait, etc.","type":"string"},"language":{"description":"Filter by language: go, python, c, cpp, rust, java, typescript, javascript, etc.","type":"string"},"limit":{"description":"Maximum results (1-200, default 50)","type":"number"},"query":{"description":"Search query (symbol name, partial name, or keyword)","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["query"]}},{"name":"search_wiki","description":"Full-text search (websearch syntax) of wiki.postgresql.org. By default searches each page's current text; history=true searches every revision and returns, per page, the latest matching revision (rev_id, revision_url, author, comment, timestamp, is_current) and how many matched; since/until bound the revision dates. Read a page with get_wiki_page; cite its wiki url.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"history":{"description":"Search every revision, not only the current text (default false)","type":"boolean"},"limit":{"description":"Maximum results to return (1-50, default 20)","type":"number"},"query":{"description":"Search query string","type":"string"},"since":{"description":"With history: only revisions at or after this date (YYYY-MM-DD or ISO-8601)","type":"string"},"until":{"description":"With history: only revisions before the end of this date (YYYY-MM-DD or ISO-8601)","type":"string"}},"required":["query"]}},{"name":"semantic_search","description":"Search messages on every list (or the lists in inbox) by semantic similarity using vector embeddings; each result names its inbox. Returns messages most similar in meaning to the query text. Requires embeddings to be generated first (see embedding_status). Each result carries an 'excerpt': the author's own words, quoted text and signatures removed.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inbox":{"description":"Lists to search: omit (or \"all\") for every list, the default; one name such as pgsql-bugs; or several, comma-separated (\"pgsql-hackers,pgsql-bugs\"). Names from list_inboxes. Aliases: list, inbox_name.","type":"string"},"limit":{"description":"Maximum results to return (1-50, default 20)","type":"number"},"query":{"description":"Natural language query to search for semantically similar messages","type":"string"}},"required":["query"]}},{"name":"semantic_search_code","description":"Search code symbols by semantic similarity using vector embeddings. Requires embeddings.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"limit":{"description":"Maximum results (1-50, default 20)","type":"number"},"query":{"description":"Natural language query","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["query"]}},{"name":"symbols_in_file","description":"List all code symbols defined in a file, ordered by line number.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"path":{"description":"File path within the repository","type":"string"},"repository":{"description":"Repository name, e.g. pgbouncer. Defaults to postgres when omitted. Aliases: repo, repo_name.","type":"string"}},"required":["path"]}},{"name":"upcoming_events","description":"PostgreSQL community events in a date window: conferences, PGDays, meetups, online events, Call for Papers and registration deadlines, conference talks (with speakers and their pg.ddx.io person hash), Talking Postgres episodes, release dates and commitfests. Same data as the iCalendar feeds at https://pg.ddx.io/calendars (community event listings from the PostgreSQL Event Calendar, curated by Andreas Scherbaum).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"days":{"description":"Look-ahead window in days (default 90, max 730)","type":"integer"},"from":{"description":"Start date YYYY-MM-DD (default today)","type":"string"},"kind":{"description":"event, cfp, deadline, session (a conference talk), release, or signal","type":"string"},"limit":{"description":"Max rows (default 50, max 500)","type":"integer"},"offset":{"description":"Pagination offset","type":"integer"},"person":{"description":"pg.ddx.io person hash (8 hex): only their talks/appearances","type":"string"},"series":{"description":"Series slug, e.g. pgconf-eu, pgconf-dev, posette, talking-postgres","type":"string"},"speaker":{"description":"Substring of a speaker's name","type":"string"},"to":{"description":"End date YYYY-MM-DD (default from + days)","type":"string"},"where":{"description":"Country (ISO code or name, e.g. 'de', 'Germany'), region slug (europe, north-america, south-america, asia-pacific, middle-east-africa), a series slug (pgconf-eu, talking-postgres, ...), or 'online'","type":"string"}},"required":[]}},{"name":"whats_new","description":"Catch up: everything a person or group did, and where they were named, in a window, newest first per kind (mail grouped by thread). who: a name (fuzzy; close matches return ambiguous [{name, hash}]), email, hash:<8 hex>, team:<slug>, org:<name>, new:<window>, a phrase ('the core team'), or a list. since/until: ISO date, today, 2w/14d/1m, pg19 (a release's development window), all; default 14 days. during: a calendar event uid/url. topic narrows by hybrid search. Kinds: waiting (one person, no topic: what is on their radar, each with group, priority 0-100 and why), mail_from, mail_to_cc, mail_mention, git_author, git_credit, git_mention, wiki_edit, wiki_mention, commitfest, calendar, roster. Names, page hashes and urls only, never addresses. ~4 s budget; late kinds go in timed_out with partial=true. Cite each item's url. Same as GET /api/v2/activity.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"during":{"description":"A calendar event uid or url, or pg19: sets since and until to its dates","type":"string"},"kinds":{"description":"Result kinds to return (default all)","items":{"enum":["waiting","mail_from","mail_to_cc","mail_mention","git_author","git_credit","git_mention","wiki_edit","wiki_mention","commitfest","calendar","roster"],"type":"string"},"type":"array"},"limit":{"description":"Items per kind (1-100, default 20)","type":"number"},"since":{"description":"Window start: 2026-10-01, 2w, 14d, 1m, today, pg19, all (default 14 days ago)","type":"string"},"topic":{"description":"Optional topic that narrows every kind, e.g. NUMA, benchmarking","type":"string"},"until":{"description":"Window end: now (default), today 08:00, 2026-10-21T08:00, pg19","type":"string"},"who":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Who: 'Tom Lane', 'team:core-team', 'org:Amazon/AWS', 'new:30d', a 8-hex person hash, an email; a string or a list of strings"}},"required":["who"]}}],"scan":{"score":65,"grade":"C","scanned_at":"2026-10-25T04:59:56.296Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-25T04:59:56.269Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 1823ms"]},"poisoning":{"score":15,"max":15,"notes":["125 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 5 write-action tools with no auth"]},"maintenance":{"score":3,"max":15,"notes":["no repository listed"]},"identity":{"score":8,"max":10,"notes":["endpoint served from the registry-verified namespace domain"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"},{"id":"maint.no-repo","severity":"low","component":"maintenance","title":"No source repository listed"}],"inputs":{"probes":[{"url":"https://pg.ddx.io/mcp","reachable":true,"authRequired":false,"latencyMs":1823,"serverInfo":{"name":"pg.ddx.io","version":"1.0"}},{"url":"https://pg.ddx.io/mcp/sse","reachable":true,"authRequired":false,"latencyMs":2201,"serverInfo":{"name":"pg.ddx.io","version":"1.0"}}],"packages":[],"repo":{"found":false},"icon":{"url":"https://pg.ddx.io/favicon.svg","source":"site"},"presence":{"stars":null,"forks":null,"downloadsWeek":null,"license":null,"lastPushAt":null,"score":8}}}},"grade_history":[],"reviews":[]}