RIVR Documentation

This is a sovereign person instance of RIVR — one individual's federated home on a federated social/civic coordination platform. It runs independently and federates into the hosted global app (app.rivr.social) for cross-instance discovery, marketplace, and credentialing. This site documents what this instance does and how to build against it.

The person instance leads with the agent surfaces — personas and autobot, the site builder, the docs vault, and the MCP act-as endpoint that lets an agent act on your behalf with full provenance — layered over the shared social, marketplace, and wallet surfaces.

It has two tabs:

📖 Wiki

Every user-facing surface, documented at click level: what each screen is, where it lives in the app, every interaction (buttons, menus, forms) and its result, who can see or do it, and how it connects to the rest of the platform.

Start with the Wiki index for the full surface list.

🔌 API

Developer reference for building against this instance:

• Auth models — the three principals RIVR authenticates: session, MCP token, and peer signature.
• Federation protocol — the Ed25519-signed event + peer-registry endpoints this instance federates through.
• MCP + REST surface — the tool surface over /api/mcp (advertised by /.well-known/mcp and /llms.txt) plus the /api/** route tree. Agents act on your behalf through this endpoint. See the API overview.