mcp-502

502 North-Central Kentucky — WellSpr.ing Civic MCP Portal

Civic AI portal for Louisville and North-Central Kentucky — Derby City, bourbon country, and Ohio River civic life.

---

Quick Start

Connect any MCP-compatible AI assistant to the Louisville civic portal:

# Claude Desktop, Cursor, Continue, or any MCP client:
npx @modelcontextprotocol/cli connect https://mcp.502.today/mcp

Or in claude_desktop_config.json:

{
  "mcpServers": {
    "502-civic": {
      "command": "npx",
      "args": ["@modelcontextprotocol/cli", "connect", "https://mcp.502.today/mcp"]
    }
  }
}

About Louisville

This repository is the sovereign source configuration for the 502.today civic MCP portal — a Model Context Protocol endpoint exposing community-scoped civic AI tools for 502 North-Central Kentucky.

Property	Value
Area code	502
Primary city	Louisville
State	KY
Live portal	502.today
MCP endpoint	mcp.502.today/mcp
Sovereign repo	git.wellspr.ing/WellBuilder/mcp-502
Federation	wellspr.ing/mcp/federation.json

Civic Tools

Tool	Description
get_local_news	Latest civic news for Louisville
get_free_items	Community free-item exchange — hyperlocal mutual aid
get_businesses	Local business directory for Louisville
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): 513, 931, 270

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
• VCAP Attestation
• Sovereignty Statement

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-502	Source of truth
Community mirror	codeberg.org/wellspring/mcp-502	Discovery
GitHub mirror	github.com/WellBuilder/mcp-502	Discovery (if restored)

See 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.

All contributions are reviewed against the Eight Principles.

---

Part of the WellSpr.ing NNN.today civic AI network — 191 area-code portals, covenant governed, architecturally sovereign.