Rithmo MCP server

Rithmo MCP — examples

Runnable examples for connecting to Rithmo's read-only MCP server.

Rithmo is a system of record for decisions. This server lets your tools query the decision record before they act — "what did we actually decide about X?" — and react when decisions change. Rithmo emits the record; your tools act on it. Rithmo never takes actions in your systems.

It speaks the Model Context Protocol, so it works with n8n, AI agents, and anything else that speaks MCP.

New here? Start with the Integration Guide — what it is, how to get

access, how to connect, and the full tool reference.

Run it in a few minutes

git clone https://github.com/Rithmo-Inc/rithmo-mcp-examples
cd rithmo-mcp-examples
npm install
cp .env.example .env      # then edit .env

Set two values in .env:

https://app.rithmo.ai/api/mcp; a self-hosted deployment exposes the same server at your own address.

• RITHMOMCPURL — the MCP endpoint of a Rithmo instance. Rithmo Cloud is

one org, carrying the mcp:read scope).

• RITHMOMCPTOKEN — a per-organization Rithmo MCP service token (read-only, scoped to

Then:

node examples/query_decision.mjs "What did we decide about GitHub integration?"
node examples/no_record.mjs
node examples/list_decision_changes.mjs

What you'll see

querydecision — the current decision, or norecord:

Q: What did we decide about GitHub integration?
✓ found (confidence 0.66)
  answer: Look into GitHub integration details, including permissions and OAuth requirements.
  status: open
  owner:  participant_50332672
  source: meeting · <source ref>
  decided_at: 2026-07-09T14:39:48.296Z

norecord** — Rithmo will not fabricate a decision (the differentiator):

Q: Did we decide anything about office snacks?
∅ no_record — Rithmo will not fabricate a decision.
   Branch here: pause the automation, route to a human, or use a safe default.

A norecord may carry a typed refusal explaining why* it is held:

Q: Are we still migrating to the new billing provider?
∅ no_record — held (closed · superseded)
   subject: Billing provider migration
   held_because: That decision was superseded; acting on the old premise is unsafe.
   safe_to_proceed: false

listdecisionchanges — a cursor-drained feed of decisions changing state:

changes: 20   has_more: true
next cursor: 1783606904319_f901849e-...   ← pass this as the argument on the next poll
  [open] Push the local build after the meeting ends.  (changed 2026-07-09T14:21:44.319Z)
  ...

The tools

query_decision

Look up the current authoritative decision for a natural-language question.

Input

Output — a discriminated union on result with three variants: "found", "foundrecord", and "norecord".

Shortened. The full README is on GitHub.