English Français العربية

io.github.suomimasuda/rightos-mcp

Official registry Security

RightOS MCP: privacy-first QR queue/EV/pickup. 20 tools, no end-user PII.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @i-s3/rightos-mcp
Claude Code 
claude mcp add rightos-mcp -e 'RIGHTOS_API_KEY=<your rightos_api_key>' -e 'RIGHTOS_BASE_URL=<RIGHTOS_BASE_URL>' -- npx -y @i-s3/rightos-mcp@0.5.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "rightos-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@i-s3/rightos-mcp@0.5.1"
            ],
            "env": {
                "RIGHTOS_API_KEY": "<your rightos_api_key>",
                "RIGHTOS_BASE_URL": "<RIGHTOS_BASE_URL>"
            }
        }
    }
}

Environment variables

  • RIGHTOS_API_KEY secret Operator API key (optional; demo: rk_demo_00000000000000000000)
  • RIGHTOS_BASE_URL Override API base URL (default: production)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. RightOS SDKs
  2. SDKs
  3. MCP servers (for AI agents)
  4. Quick example (TypeScript)
  5. Quick example (Python)
  6. Resources
  7. Privacy & security design
  8. License

RightOS SDKs

Official SDKs for RightOS — privacy-preserving rights verification infrastructure by I-S3 (Japan).

RightOS turns queues, reservations, EV charging, and package pickup into digital QR tickets ("Right Tokens"). It verifies that a valid right is present — never who the person is. No names, phone numbers, or birthdates are required from end users.

RightOS is not a taxi or ride-hailing service. It does not arrange vehicles, set fares, assign drivers, or broker dispatch.

SDKs

LayerQuestionPackages
RightOSWhat may be done?@i-s3/rightos · @i-s3/rightos-mcp
RightFlowWhat should happen next?@i-s3/rightflow · @i-s3/rightflow-mcp
ExecutionHow is it done?your systems

RightOS / RightFlow SDKs install via package managers (or download the thin client files).

LanguagePackageSingle fileRequirements
TypeScripttypescript/ — @i-s3/rightosrightos.tsNode.js ≥ 18 or a modern browser
Pythonpython/ — rightos-sdkrightos.pyPython ≥ 3.9, standard library only
TypeScriptrightflow/ — @i-s3/rightflowrightflow.tsNode.js ≥ 18 or a modern browser

RightFlow is coordination beside RightOS — not a redesign. No money, marketplace, dispatch, or robot control in the core.

MCP servers (for AI agents)

mcp/ — @i-s3/rightos-mcp: rights tools (issue / verify / transfer).

rightflow-mcp/ — @i-s3/rightflow-mcp: coordination tools (tasks / actors / proposals / transitions). Separate from RightOS MCP.

{
  "mcpServers": {
    "rightos": {
      "command": "npx",
      "args": ["-y", "@i-s3/rightos-mcp"],
      "env": { "RIGHTOS_API_KEY": "rk_live_..." }
    },
    "rightflow": {
      "command": "npx",
      "args": ["-y", "@i-s3/rightflow-mcp"],
      "env": { "RIGHTOS_API_KEY": "rk_live_..." }
    }
  }
}

Quick example (TypeScript)

import { RightOS } from "@i-s3/rightos";

const client = new RightOS({ apiKey: "rk_live_..." });
const [location] = await client.listLocations();
const issued = await client.issueToken({ locationId: location.id, title: "Queue ticket" });
// Hand issued.walletUrl (QR page) to your customer
const outcome = await RightOS.verify(issued.token.id, issued.verificationCode);
// outcome.result === "success"

Quick example (Python)

from rightos import RightOS

client = RightOS(api_key="rk_live_...")
location = client.list_locations()[0]
issued = client.issue_token(location_id=location["id"], title="Queue ticket")
outcome = RightOS().verify_token(issued["token"]["id"], issued["verificationCode"])
# outcome["result"] == "success"

Resources

Privacy & security design

  • The verification code is handed to the holder exactly once; the server stores only its SHA-256 hash.
  • Transfers use re-keying: a new code is issued and the old one is invalidated immediately.
  • QR codes contain only the tokenId and verificationCode — no personal data.
  • Paid transfers and auctions are not offered.

License

MIT © I-S3 Inc.

Frequently asked questions

What is io.github.suomimasuda/rightos-mcp?

RightOS MCP: privacy-first QR queue/EV/pickup. 20 tools, no end-user PII.

How do I install io.github.suomimasuda/rightos-mcp?

It runs on your machine. In Claude Code: claude mcp add rightos-mcp -e 'RIGHTOS_API_KEY=<your rightos_api_key>' -e 'RIGHTOS_BASE_URL=<RIGHTOS_BASE_URL>' -- npx -y @i-s3/rightos-mcp@0.5.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.suomimasuda/rightos-mcp need an API key?

Yes. It expects RIGHTOS_API_KEY, which you set in its configuration.

Is io.github.suomimasuda/rightos-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.suomimasuda/rightos-mcp?

It is published by suomimasuda. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.