Skip to main content
Glama
AI Buildout Permits

AI Buildout Permits

README.md
# AI Buildout Permits

**Live:** https://aibuildoutpermits.vercel.app

US AI data-center projects from public records (state tax certifications, air permits, generator
filings, city and county agendas), with named tenants and operators resolved to stock tickers and
the date every fact first appeared. A remote MCP connector for Claude, plus a public site.

Texas lists every certified data center with its owner, operator and occupant. The occupant is the
tenant, often hidden behind a project LLC: Cipher's Barber Lake site lists Anthropic; Cipher Black
Pearl lists Amazon. This repo reads those lists every day and keeps the history.

## Use it

MCP endpoint (Streamable HTTP): `https://aibuildoutpermits.vercel.app/mcp`

```bash
claude mcp add --transport http ai-buildout-permits https://aibuildoutpermits.vercel.app/mcp
```

More clients (Claude, Codex, Cursor, VS Code, Python): https://aibuildoutpermits.vercel.app/connect.
Claude directory: filed 2026-11-20, in review (`SUBMISSION.md`). Official MCP registry:
`io.github.2016judea/ai-buildout-permits`.

| Tool | Tier | Returns |
|---|---|---|
| `whats_new` | free | dated events (certifications, permits, rezonings, moratoria, changes) |
| `find_projects` | free | search and screen projects; true totals |
| `project_detail` | free | one project's parties, ticker links, power, timeline, sources |
| `company_exposure` | paid | every project resolving to a ticker, with first-seen dates |
| `equipment_tracker` | paid | turbines and engines by maker and model, quoted from permits |
| `pipeline_series` | paid | counts over time by state, ticker, event type |
| `export` | paid | CSV or Parquet with first-seen dates |

Free: 10 rows and the true total; `whats_new` covers 30 days. Paid: $99/month or $990/year. Paid
tools use Claude's lazy authentication (HTTP 401 → Connect card → OAuth → retry); subscribers can
also send their access key as `Authorization: Bearer abp_live_…`.

## How it's built

- `DATA_MODEL.md`: the ideal model, a field-by-field reality check, the expected numbers.
- `pipeline/`: Python. One module per source in `pipeline/sources/`; `merge.py` stamps first_seen and
  keeps history append-only; `tickers.py` resolves names to parents; `publish.py` loads the Worker.
  `run.py` is the daily job on GitHub Actions (`.github/workflows/refresh.yml`, 11:17 UTC), never a laptop.
- `worker/`: Cloudflare Worker. MCP server, OAuth 2.1 authorization server (CIMD + DCR, PKCE, rotating
  refresh), Stripe subscriptions, D1 for serving tables, KV for the daily ledger snapshots and Parquet
  exports. No model API is called anywhere in the request path.
- `site/build.mjs`: the static site, generated from the same data on every Vercel build. Vercel proxies
  `/mcp`, the OAuth endpoints and `/export` to the Worker so everything lives on one origin.
- Discovery: `llms.txt`, `llms-full.txt`, `sitemap.xml`, a robots.txt that welcomes AI crawlers,
  schema.org `Dataset` JSON-LD, an MCP Server Card at `/mcp/server-card` (SEP-2127) and
  `/.well-known/ai-catalog.json`.
- `sample/`: the Texas list resolved to tickers, CC BY 4.0, also on Hugging Face
  (`aidanjude/ai-buildout-permits-texas-sample`).
- `design/ive-review.md`: the design review rounds behind the site.
- `drafts/`: records-request drafts for Virginia, Ohio and Georgia (not sent).

Tests: `uv run --with pytest --with pdfplumber --with openpyxl --with pyarrow --with certifi pytest -q`
(also run in CI before each refresh). Live: `cd worker && ABP_TEST_KEY=… node scripts/live_cases.mjs`
and `node scripts/oauth_flow.mjs`.

## Ticker resolution

Names resolve by dated rules in `pipeline/ref/ticker_aliases.json` (`alias` when the parent's brand is
in the name, `curated` when a public fact ties them) and by exact matches in parents' 10-K Exhibit 21
lists (`ex21`). SEC requires an email-shaped contact from every client, and choosing it is the
operator's call: run `scripts/set_sec_contact.sh "Name email"` once and the Monday refresh rebuilds the
Exhibit 21 index.

## Sources and rights

Texas Comptroller (public domain), Virginia DEQ's published air-site map layers (the service URL on
DEQ's open-data item), EPA ECHO (ICIS-Air), Minnesota DEED, EIA-860M (credit EIA), agency-hosted
air-permit documents, and the Legistar Web API. Not used: CivicPlus or BoardDocs agendas, ISO queues
outside ERCOT/CAISO, procurement portals, deed owner names, any host whose robots.txt says no, or
anything behind a bot check. People appear only in a business role from a government record; citizen
comments on agendas are excluded. Details: https://aibuildoutpermits.vercel.app/methodology

## Support

Issues: https://github.com/2016judea/ai-buildout-permits/issues