docs update

.gitignore

@@ -3,6 +3,7 @@ ed25519tool
 scripts/*/node_modules/
 scripts/*/package-lock.json
 stackql*.sh
+/stackql_mcp_server_*.log
 /stackql
 stackql-zip
 .stackql/

README.md

@@ -6,6 +6,85 @@
 
 A repository of `provider` interface documents supporting [stackql](https://stackql.io/) ([stackql GitHub repo](https://github.com/stackql/stackql)). 
 
+## Table of Contents
+
+<!-- BEGIN TABLE OF CONTENTS -->
+- [Provider Catalog](#provider-catalog)
+  - [Updating the Catalog](#updating-the-catalog)
+- [Context](#context)
+- [Contributing](#contributing)
+- [Developing a Provider](#developing-a-provider)
+- [Build and Deployment Workflow](#build-and-deployment-workflow)
+- [Testing a Provider using the `dev` Registry](#testing-a-provider-using-the-dev-registry)
+<!-- END TABLE OF CONTENTS -->
+
+## Provider Catalog
+
+The following StackQL providers are available in the public StackQL Provider Registry. Use `REGISTRY LIST` to discover providers and `REGISTRY PULL <provider>` to install one.
+
+<!-- BEGIN PROVIDER CATALOG -->
+| Icon | Provider | Full Name | Latest Version | Date First Published | Date Last Published |
+| --- | --- | --- | --- | --- | --- |
+| <img src="images/anthropic.png" alt="Anthropic" width="24" height="24"> | `anthropic` | Anthropic | `v26.09.00461` | 2024-10-25 | 2026-09-15 |
+| <img src="images/anthropic.png" alt="Anthropic Admin" width="24" height="24"> | `anthropic_admin` | Anthropic Admin | `v26.07.00416` | 2026-07-09 | 2026-07-09 |
+| <img src="images/aws.ico" alt="Amazon Web Services" width="24" height="24"> | `aws` | Amazon Web Services | `v26.08.00444` | 2022-08-19 | 2026-08-20 |
+| <img src="images/aws.ico" alt="AWS Cloud Control" width="24" height="24"> | `awscc` | AWS Cloud Control | `v26.07.00426` | 2024-03-07 | 2026-07-28 |
+| <img src="images/azure.ico" alt="Microsoft Azure" width="24" height="24"> | `azure` | Microsoft Azure | `v26.07.00420` | 2022-08-20 | 2026-07-14 |
+| <img src="images/azure.ico" alt="Azure Extras" width="24" height="24"> | `azure_extras` | Azure Extras | `v26.07.00420` | 2022-08-20 | 2026-07-14 |
+| <img src="images/azure.ico" alt="Azure ISV" width="24" height="24"> | `azure_isv` | Azure ISV | `v26.07.00420` | 2024-01-25 | 2026-07-14 |
+| <img src="images/azure.ico" alt="Azure Stack" width="24" height="24"> | `azure_stack` | Azure Stack | `v26.07.00420` | 2024-01-25 | 2026-07-14 |
+| <img src="images/clickhouse.ico" alt="ClickHouse" width="24" height="24"> | `clickhouse` | ClickHouse | `v26.08.00442` | 2026-08-17 | 2026-08-17 |
+| <img src="images/cloudflare.ico" alt="Cloudflare" width="24" height="24"> | `cloudflare` | Cloudflare | `v26.07.00424` | 2023-03-24 | 2026-07-21 |
+| <img src="images/confluent.ico" alt="Confluent" width="24" height="24"> | `confluent` | Confluent | `v26.05.00403` | 2024-11-01 | 2026-05-31 |
+| <img src="images/databricks.ico" alt="Databricks Account" width="24" height="24"> | `databricks_account` | Databricks Account | `v26.07.00430` | 2024-12-20 | 2026-07-30 |
+| <img src="images/databricks.ico" alt="Databricks Workspace" width="24" height="24"> | `databricks_workspace` | Databricks Workspace | `v26.07.00430` | 2024-12-20 | 2026-07-30 |
+| <img src="images/datadog.ico" alt="DataDog" width="24" height="24"> | `datadog` | DataDog | `v26.08.00455` | 2023-12-28 | 2026-08-26 |
+| <img src="images/deno.ico" alt="Deno Deploy" width="24" height="24"> | `deno` | Deno Deploy | `v26.09.00459` | 2025-09-09 | 2026-09-15 |
+| <img src="images/digitalocean.png" alt="Digital Ocean" width="24" height="24"> | `digitalocean` | Digital Ocean | `v26.08.00434` | 2023-03-24 | 2026-08-03 |
+| <img src="images/entra_id.svg" alt="Microsoft Entra ID" width="24" height="24"> | `entra_id` | Microsoft Entra ID | `v26.07.00412` | 2026-06-02 | 2026-07-06 |
+| <img src="images/firebase.png" alt="Firebase" width="24" height="24"> | `firebase` | Firebase | `v26.08.00446` | 2022-07-04 | 2026-08-20 |
+| <img src="images/fivetran.png" alt="Fivetran" width="24" height="24"> | `fivetran` | Fivetran | `v26.09.00467` | 2023-03-17 | 2026-09-28 |
+| <img src="images/github.ico" alt="GitHub" width="24" height="24"> | `github` | GitHub | `v26.08.00448` | 2022-05-02 | 2026-08-20 |
+| <img src="images/gitlab.ico" alt="GitLab" width="24" height="24"> | `gitlab` | GitLab | `v26.09.00465` | 2026-09-26 | 2026-09-26 |
+| <img src="images/godaddy.png" alt="GoDaddy" width="24" height="24"> | `godaddy` | GoDaddy | `v26.09.00463` | 2023-12-16 | 2026-09-16 |
+| <img src="images/googleadmin.ico" alt="Google Admin" width="24" height="24"> | `googleadmin` | Google Admin | `v26.07.00432` | 2023-07-07 | 2026-07-31 |
+| <img src="images/google.ico" alt="Google Cloud Platform" width="24" height="24"> | `googleapis.com` | Google Cloud Platform | `v26.08.00446` | 2022-03-15 | 2026-08-20 |
+| <img src="images/googleworkspace.ico" alt="Google Workspace" width="24" height="24"> | `googleworkspace` | Google Workspace | `v26.07.00432` | 2023-01-08 | 2026-07-31 |
+| <img src="images/homebrew.ico" alt="Homebrew" width="24" height="24"> | `homebrew` | Homebrew | `v25.01.00292` | 2023-12-28 | 2025-01-27 |
+| <img src="images/k8s.png" alt="Kubernetes" width="24" height="24"> | `k8s` | Kubernetes | `v26.08.00453` | 2022-06-19 | 2026-08-24 |
+| <img src="images/kafka.png" alt="Kafka" width="24" height="24"> | `kafka` | Kafka | `v26.05.00403` | 2026-05-31 | 2026-05-31 |
+| <img src="images/lambda.svg" alt="Lambda Cloud" width="24" height="24"> | `lambda` | Lambda Cloud | `v26.10.00481` | 2026-10-21 | 2026-10-21 |
+| <img src="images/linode.ico" alt="Linode" width="24" height="24"> | `linode` | Linode | `v26.08.00440` | 2023-05-12 | 2026-08-04 |
+| <img src="images/netlify.ico" alt="Netlify" width="24" height="24"> | `netlify` | Netlify | `v26.08.00457` | 2022-05-11 | 2026-08-28 |
+| <img src="images/nvidia.ico" alt="NVIDIA NGC" width="24" height="24"> | `nvidia` | NVIDIA NGC | `v26.10.00479` | 2026-10-19 | 2026-10-19 |
+| <img src="images/oci.ico" alt="Oracle Cloud Infrastructure" width="24" height="24"> | `oci` | Oracle Cloud Infrastructure | `v26.10.00475` | 2026-10-05 | 2026-10-05 |
+| <img src="images/okta.png" alt="Okta" width="24" height="24"> | `okta` | Okta | `v26.08.00436` | 2022-03-15 | 2026-08-04 |
+| <img src="images/openai.ico" alt="OpenAI" width="24" height="24"> | `openai` | OpenAI | `v26.07.00422` | 2024-10-25 | 2026-07-15 |
+| <img src="images/openai.ico" alt="OpenAI Admin" width="24" height="24"> | `openai_admin` | OpenAI Admin | `v26.07.00422` | 2026-07-15 | 2026-07-15 |
+| <img src="images/pagerduty.svg" alt="PagerDuty" width="24" height="24"> | `pagerduty` | PagerDuty | `v26.09.00459` | 2023-12-20 | 2026-09-15 |
+| <img src="images/railway.ico" alt="Railway" width="24" height="24"> | `railway` | Railway | `v26.09.00469` | 2026-09-28 | 2026-09-28 |
+| <img src="images/snowflake.ico" alt="Snowflake" width="24" height="24"> | `snowflake` | Snowflake | `v26.08.00438` | 2025-05-20 | 2026-08-04 |
+| <img src="images/sumologic.png" alt="SumoLogic" width="24" height="24"> | `sumologic` | SumoLogic | `v26.09.00459` | 2022-12-10 | 2026-09-15 |
+| <img src="images/supabase.ico" alt="Supabase" width="24" height="24"> | `supabase` | Supabase | `v26.10.00477` | 2026-10-12 | 2026-10-12 |
+| <img src="images/typesafe.png" alt="TypeSafe AI" width="24" height="24"> | `typesafe` | TypeSafe AI | `v26.10.00473` | 2026-10-04 | 2026-10-04 |
+| <img src="images/vercel.ico" alt="Vercel" width="24" height="24"> | `vercel` | Vercel | `v26.09.00459` | 2023-12-14 | 2026-09-15 |
+<!-- END PROVIDER CATALOG -->
+
+Latest versions come from the [production registry manifest](https://registry.stackql.app/providers/dist/providers.yaml). Dates are UTC, inferred from production Git history: **Date First Published** is the earliest commit on the production branch that introduced the provider's source or packaged artifacts; **Date Last Published** is the release commit corresponding to its latest published version. These are Git-based publication estimates, not deployment completion timestamps. `googleapis.com` is the source directory for the registry provider named `google`.
+
+### Updating the Catalog
+
+With Node.js 18 or later, internet access, and a full Git checkout, run:
+
+```bash
+git fetch origin main
+node scripts/docs/update_provider_listings.js
+```
+
+The script updates the catalog and table of contents in this README. It reads published versions from the production registry and dates from `origin/main`; use `--git-ref <ref>` to select another local production-history ref, or `--check` to check for stale content without writing. It fails explicitly if metadata, local icons, or release history are missing. When adding a provider, add its display name and icon mapping to the script and its favicon to `images/`.
+
+Favicons and display names were initially copied from the [StackQL website provider tiles](https://stackql.io/providers); Lambda Cloud's favicon comes from [Lambda](https://lambda.ai/favicon.ico), as it did not yet have a website tile. Brand spelling and capitalization are preserved.
+
 ## Context