# SafeSenders.org
> A publicly accessible, covenant-governed registry of trusted SMS communicators and their consenting audiences.

## About

SafeSenders.org is a WellSpr.ing initiative creating a public trust layer for SMS communication. Senders sign an eight-principle covenant committing to honest identity, genuine value, effortless opt-out, and suppression list compliance. Recipients consent explicitly and their opt-outs are honored across the entire network via a shared suppression ledger.

The long-term goal: make it easier for carriers to accept SafeSenders than to defend blocking consented communications in court.

## Trust Tiers

- **Attested** — Self-attested covenant signature. Good faith commitment.
- **Civic** — Endorsed by a civic anchor (municipality, school district, or tribal government).
- **Municipal** — A government entity itself. Highest public trust tier.

## Public API — No Auth Required

Base URL: https://safesenders.org

### Registry
- GET /api/ss/stats — Registry statistics: active senders, consents, suppressions, carrier counts
- GET /api/ss/senders — Sender directory. Query params: ?tier=attested|civic|municipal&status=active&q=name
- GET /api/ss/senders/:id — Full sender profile: name, tier, covenant signature date, registered numbers
- GET /api/ss/verify?number=:e164 — Check if a number is registered in the SafeSenders registry
- GET /api/ss/ledger — Public suppression ledger. Shows opted-out numbers with reason and timestamp.
- GET /api/ss/carriers — Carrier status registry: which carriers have accepted or are blocking SafeSenders
- GET /api/ss/regimes — International regulatory regime map by country code
- GET /api/ss/anchors — Civic anchor organizations that have endorsed SafeSenders senders

### Recipient Actions
- POST /api/ss/optin — Consent to receive messages from a sender { sender_id, phone_e164, method }
- POST /api/ss/optout — Opt out of a sender or all SafeSenders { phone_e164, sender_id?, reason? }

### MCP (Model Context Protocol)
SafeSenders exposes a native MCP interface for AI assistants and compliance agents.
**Endpoint**: POST https://safesenders.org/api/ss/mcp
**Transport**: Streamable HTTP (MCP 2025-03-26 spec)
**Authentication**: None required for public read tools

#### Available MCP Tools
- **search_senders** — Query the registry by name, organization, tier, or area code
- **verify_number** — Check if a specific phone number is registered as a SafeSender
- **check_suppression** — Check if a number is on the shared suppression ledger
- **get_carrier_status** — Check a carrier's covenant acceptance status
- **get_stats** — Current registry statistics
- **get_covenant** — Return the full SafeSenders Covenant text (all 8 principles)

## Pages
- / — Landing, mission, stats
- /covenant — The SafeSenders Covenant (8 principles)
- /senders — Public sender directory
- /carriers — Carrier status board
- /world — International regulatory regime map
- /ledger — Public suppression ledger
- /register — Sender registration (3-step wizard)
- /dashboard — Authenticated sender dashboard

## Discovery Files
- /llms.txt — This file
- /sitemap.xml — XML sitemap
- /robots.txt — Crawl permissions
- /.well-known/ai-plugin.json — AI plugin manifest

## Covenant Summary (Version 2.0 · April 1, 2026)

Signatories commit to: (I) honest sender identity; (II) recipient-first content; (III) effortless permanent opt-out; (IV) shared suppression ledger compliance; (V) proportionate sending frequency; (VI) no deception or dark patterns; (VII) public record acceptance; (VIII) good-faith correction of failures.

A WellSpr.ing Initiative. https://wellspr.ing