diff --git a/llms.txt b/llms.txt
new file mode 100644
index 0000000..7a53f0f
--- /dev/null
+++ b/llms.txt
@@ -0,0 +1,36 @@
+# 502 502 North-Central Kentucky — LLMs.txt
+
+> Civic AI portal for Louisville and North-Central Kentucky — Derby City, bourbon country, and Ohio River civic life.
+
+## This Repository
+
+MCP (Model Context Protocol) server configuration for the Louisville, KY civic AI portal.
+
+- Area code: 502
+- Network: WellSpr.ing NNN.today
+- Endpoint: https://mcp.502.today/mcp
+- Sovereign repo: https://git.wellspr.ing/WellBuilder/mcp-502
+
+## Tools Available
+
+- get_local_news — civic news for Louisville
+- get_free_items — hyperlocal mutual aid exchange
+- get_businesses — local business directory
+- submit_civic_idea — civic participation intake
+- get_civic_services — government services directory
+- ody_chat — covenant-governed conversational AI
+
+## Governance
+
+Covenant governed. Eight Principles: https://wellspr.ing/constitution
+VCAP attestation: https://wellspr.ing/vault/ody/attestation-2026-04-17.json
+
+## Adjacent Portals
+
+- 513.today — https://mcp.513.today/mcp
+- 931.today — https://mcp.931.today/mcp
+- 270.today — https://mcp.270.today/mcp
+
+## Federation
+
+Full 32-portal manifest: https://wellspr.ing/mcp/federation.json