Repository avatar
AI Tools
v0.1.0
active

ai-buildout-permits

io.github.2016judea/ai-buildout-permits

US AI data-center projects from public records: tenants, air permits, turbines, resolved to tickers

Documentation

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

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.

ToolTierReturns
whats_newfreedated events (certifications, permits, rezonings, moratoria, changes)
find_projectsfreesearch and screen projects; true totals
project_detailfreeone project's parties, ticker links, power, timeline, sources
company_exposurepaidevery project resolving to a ticker, with first-seen dates
equipment_trackerpaidturbines and engines by maker and model, quoted from permits
pipeline_seriespaidcounts over time by state, ticker, event type
exportpaidCSV 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