API and MCP
Reading the record back.
The gateway serves memory over HTTP to any client. rh mcp serves it to agents.
Gateway
- Binds
127.0.0.1:5174by default. Off loopback it refuses to start without TLS (gateway.tls_cert,gateway.tls_key). - Loopback alone grants no access. Local scripts send the owner token from
rh auth token-path. Remote callers sendAuthorization: Bearer <token>for a user in the users file; an unknown token is refused, even on loopback. - Browser origins other than the gateway’s own must be listed in
gateway.allowed_origins. GET /healthzreports the node’s health;rh statusreads it. Itssessionsfield still reports 0; count captured sessions through/api/sessions.
The payload schemas are in contract/. The Memory service reference covers the contract version a client checks, and the Command-line reference every command.
MCP
{ "mcpServers": { "rivethub": { "command": "rh", "args": ["mcp"] } } }| Tool | Does |
|---|---|
memory_search | hybrid, full-text, trigram, regex or vector search over messages and summaries |
memory_browse | messages in a time window, oldest or newest first |
memory_team | recent visible sessions grouped by teammate on a shared datahub; private sessions stay hidden |
memory_get_full | the full text of a hit that search truncated |
memory_stats | counts, queues and freshness for the store |
memory_tags | the tags filed on conversations |
wiki_search, wiki_read | search and read wiki pages |
rh mcp serves stdio by default, and streamable HTTP at /mcp when transports.mcp names a host (bearer auth_token required) or a socket. It acts as the node’s owner. rh harness connect adds the stdio entry to a tool for you.
What rh reports
Capture stays on your chosen storage; configured model endpoints receive session text, and sharing sends selected bundles. Runtime reporting is separate from this website’s consent: a node sends two things to rivethub.cloud by default:
- Crash reports: the version, operating system, the job that crashed, and the panic site and backtrace as module names and line numbers. The panic message, file paths, hostnames, user names and memory text are never read into it.
- A daily usage count: the version, operating system, and the day’s number of searches and app opens.
telemetry:
disabled: trueBoth carry a random install id from ~/.rivethub/account/install.json. Privacy has the rest.
Nothing to read back yet?
The quickstart captures a first session in a few minutes.