
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.
| 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 inpipeline/sources/;merge.pystamps first_seen and keeps history append-only;tickers.pyresolves names to parents;publish.pyloads the Worker.run.pyis 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/exportto the Worker so everything lives on one origin.- Discovery:
llms.txt,llms-full.txt,sitemap.xml, a robots.txt that welcomes AI crawlers, schema.orgDatasetJSON-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
No installation packages available.
Remote
Related Servers
io.github.2016judea/appeal-draft
Is my Twin Cities property tax assessment too high? County value vs. recorded sales, when to appeal
io.github.2016judea/breach-to-claim
Am I owed money from a data breach? Open settlements, deadlines, payouts and official claim sites
io.github.2016judea/small-business-intelligence
Free joined public records for small business and CRE: Twin Cities parcels, sales, licences