# Brainshare

Brainshare is a governed shared-memory service for a human and their authorized AI clients.
It provides bounded retrieval and revision-safe knowledge capture, proposal, review, approval, and audit workflows.

MCP endpoint: https://brainshare.duckdns.org/mcp
OAuth protected-resource metadata: https://brainshare.duckdns.org/.well-known/oauth-protected-resource
Authentication: OAuth 2.1 authorization-code flow with PKCE; follow the advertised metadata and sign in in the browser.

## AI client operating contract

1. Connect to the MCP endpoint and complete OAuth authentication.
2. Read the MCP server instructions and call `memory_manifest` at connection and reconnection.
3. Use `retrieve_context` for bounded accepted evidence before answering from shared memory.
4. Use the available governed tools for durable changes; never invent identity, authority, owners, revisions, or approvals.
5. Treat model output as an untrusted candidate and let Brainshare enforce deterministic governance.

The public document contains no participant identity, credentials, private note content, or grant mappings.