All pages

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:5174 by 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 send Authorization: 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 /healthz reports the node’s health; rh status reads it. Its sessions field 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"] } } }
ToolDoes
memory_searchhybrid, full-text, trigram, regex or vector search over messages and summaries
memory_browsemessages in a time window, oldest or newest first
memory_teamrecent visible sessions grouped by teammate on a shared datahub; private sessions stay hidden
memory_get_fullthe full text of a hit that search truncated
memory_statscounts, queues and freshness for the store
memory_tagsthe tags filed on conversations
wiki_search, wiki_readsearch 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.
~/.rivethub/config.yaml: nothing is sent
telemetry:
  disabled: true

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