mcp-845/README.md

# mcp-845

**845 Hudson Valley, New York — WellSpr.ing Civic MCP Portal**

> Civic AI portal for Poughkeepsie and the Mid-Hudson Valley — Vassar, Marist, and Hudson River Valley civic community.

[![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 Poughkeepsie / New Paltz civic portal:

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

Or in `claude_desktop_config.json`:

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

## About Poughkeepsie / New Paltz

This repository is the sovereign source configuration for the **845.today** civic MCP portal — a [Model Context Protocol](https://modelcontextprotocol.io) endpoint exposing community-scoped civic AI tools for 845 Hudson Valley, New York.

| Property | Value |
|----------|-------|
| **Area code** | 845 |
| **Primary city** | Poughkeepsie / New Paltz |
| **State** | NY |
| **Live portal** | [845.today](https://845.today) |
| **MCP portal** | [mcp.845.today](https://mcp.845.today/) |
| **MCP protocol endpoint** | `https://mcp.845.today/mcp` (POST for agents) |
| **Sovereign repo** | [git.wellspr.ing/WellBuilder/mcp-845](https://git.wellspr.ing/WellBuilder/mcp-845) |
| **Federation** | [wellspr.ing/mcp/federation.json](https://wellspr.ing/mcp/federation.json) |

## Civic Tools

| Tool | Description |
|------|-------------|
| `get_local_news` | Latest civic news for Poughkeepsie / New Paltz |
| `get_free_items` | Community free-item exchange — hyperlocal mutual aid |
| `get_businesses` | Local business directory for Poughkeepsie / New Paltz |
| `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`):
[`914`](https://git.wellspr.ing/WellBuilder/mcp-914), [`212`](https://git.wellspr.ing/WellBuilder/mcp-212), [`518`](https://git.wellspr.ing/WellBuilder/mcp-518), [`570`](https://git.wellspr.ing/WellBuilder/mcp-570), [`203`](https://git.wellspr.ing/WellBuilder/mcp-203), [`860`](https://git.wellspr.ing/WellBuilder/mcp-860)

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-845](https://git.wellspr.ing/WellBuilder/mcp-845) | Source of truth |
| **Community mirror** | [codeberg.org/wellspring/mcp-845](https://codeberg.org/wellspring/mcp-845) | Discovery |
| **GitHub mirror** | github.com/WellBuilder/mcp-845 | 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-845).

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