From 42a56bcd6a48db70a5c51d3d3f86bb2034e1c16f Mon Sep 17 00:00:00 2001
From: gitadmin <ody@wellspr.ing>
Date: Sun, 19 Apr 2026 15:48:01 +0000
Subject: [PATCH] chore: provision README.md [WellSpr.ing auto]

---
 README.md | 97 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 96 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 29da5ac..d35099a 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,98 @@
 # mcp-949
 
-Civic AI portal for Irvine, Newport Beach, and South Orange County — planned city innovation, Pacific coast, and OC civic affluence.
\ No newline at end of file
+**949 South Orange County — WellSpr.ing Civic MCP Portal**
+
+> Civic AI portal for Irvine, Newport Beach, and South Orange County — planned city innovation, Pacific coast, and OC civic affluence.
+
+[![WellSpr.ing Network](https://img.shields.io/badge/network-WellSpr.ing-blue)](https://wellspr.ing)
+[![Federation v2.0](https://img.shields.io/badge/federation-v2.0-green)](https://wellspr.ing/mcp/federation.json)
+[![Covenant Governed](https://img.shields.io/badge/governance-covenant-amber)](https://wellspr.ing/constitution)
+[![MCP Protocol](https://img.shields.io/badge/protocol-MCP-purple)](https://modelcontextprotocol.io)
+
+---
+
+## Quick Start
+
+Connect any MCP-compatible AI assistant to the Irvine / Newport Beach civic portal:
+
+```bash
+# Claude Desktop, Cursor, Continue, or any MCP client:
+npx @modelcontextprotocol/cli connect https://mcp.949.today/mcp
+```
+
+Or in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "949-civic": {
+      "command": "npx",
+      "args": ["@modelcontextprotocol/cli", "connect", "https://mcp.949.today/mcp"]
+    }
+  }
+}
+```
+
+## About Irvine / Newport Beach
+
+This repository is the sovereign source configuration for the **949.today** civic MCP portal — a [Model Context Protocol](https://modelcontextprotocol.io) endpoint exposing community-scoped civic AI tools for 949 South Orange County.
+
+| Property | Value |
+|----------|-------|
+| **Area code** | 949 |
+| **Primary city** | Irvine / Newport Beach |
+| **State** | CA |
+| **Live portal** | [949.today](https://949.today) |
+| **MCP endpoint** | [mcp.949.today/mcp](https://mcp.949.today/mcp) |
+| **Sovereign repo** | [git.wellspr.ing/WellBuilder/mcp-949](https://git.wellspr.ing/WellBuilder/mcp-949) |
+| **Federation** | [wellspr.ing/mcp/federation.json](https://wellspr.ing/mcp/federation.json) |
+
+## Civic Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_local_news` | Latest civic news for Irvine / Newport Beach |
+| `get_free_items` | Community free-item exchange — hyperlocal mutual aid |
+| `get_businesses` | Local business directory for Irvine / Newport Beach |
+| `submit_civic_idea` | Submit a civic idea or community proposal |
+| `get_civic_services` | Local government services and contact information |
+| `ody_chat` | Conversational civic AI (Ody) — covenant-governed |
+
+## Network Traversal
+
+Adjacent area-code portals (connected via `get_adjacent_nodes`):
+[`714`](https://git.wellspr.ing/WellBuilder/mcp-714), [`760`](https://git.wellspr.ing/WellBuilder/mcp-760), [`619`](https://git.wellspr.ing/WellBuilder/mcp-619), [`951`](https://git.wellspr.ing/WellBuilder/mcp-951)
+
+Any MCP-capable agent connected to this portal can traverse the WellSpr.ing network hop-by-hop using `get_adjacent_nodes` — no central directory required.
+
+## Governance
+
+This portal operates under the **WellSpr.ing Eight Principles** — a covenant governance model that all portals, tools, and AI agents in the network attest to.
+
+- [Eight Principles](https://wellspr.ing/constitution)
+- [VCAP Attestation](https://wellspr.ing/vault/ody/attestation-2026-04-17.json)
+- [Sovereignty Statement](https://wellspr.ing/sovereignty)
+
+*Freely given, so freely given.*
+
+## Infrastructure
+
+This repository is the **primary source of truth**. GitHub and Codeberg are push-mirrors only.
+
+| Layer | URL | Role |
+|-------|-----|------|
+| **Sovereign primary** | [git.wellspr.ing/WellBuilder/mcp-949](https://git.wellspr.ing/WellBuilder/mcp-949) | Source of truth |
+| **Community mirror** | [codeberg.org/wellspring/mcp-949](https://codeberg.org/wellspring/mcp-949) | Discovery |
+| **GitHub mirror** | github.com/WellBuilder/mcp-949 | Discovery (if restored) |
+
+See [NotGit.org/formula](https://notgit.org/formula) for the three-mirror architecture.
+
+## Contributing
+
+WellSpr.ing covenanted developers are welcome to contribute to this portal's configuration. Open an issue or pull request on the [sovereign git](https://git.wellspr.ing/WellBuilder/mcp-949).
+
+All contributions are reviewed against the [Eight Principles](https://wellspr.ing/constitution).
+
+---
+
+*Part of the [WellSpr.ing NNN.today](https://wellspr.ing) civic AI network — 191 area-code portals, covenant governed, architecturally sovereign.*