@i-s3/rightos-mcp

@i-s3/rightos-mcp — RightOS MCP Server

MCP (Model Context Protocol) server for RightOS — lets AI agents issue, verify, and transfer digital QR tickets for queues, clinic waiting, EV charging, events, and package pickup without writing HTTP code.

For coding agents: start with npx -y @i-s3/rightos-mcp and demo key rk_demo_00000000000000000000. Full docs: llms-full.txt · OpenAPI · ai.txt

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

Setup

Add to your MCP client configuration (Cursor, Claude Desktop, etc.):

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

RIGHTOS_API_KEY is optional. Without it, only the public tools work (plans, token lookup, verify, transfer, holder cancel, location policy, policy presets). Get a key by registering an organization — free tier, no credit card.

To try it with the shared demo organization, set RIGHTOS_API_KEY to rk_demo_00000000000000000000.

Tools

Public (no API key):

Tool	Description
list_plans	List pricing plans (globally uniform)
get_token	Get a Right Token by ID (never returns the secret code)
verify_token	Verify a token with its verification code
transfer_token	Transfer a token via re-keying (old code invalidated)
holder_cancel_token	Self-cancel a token as its current holder (policy permitting)
get_location_policy	Get a location's effective policy (public for transparency)
list_policies	List all industry presets and country overlays (JP/US/GB/KR/TW/FR/DE/IT/ES/AU)

Operator (requires RIGHTOS_API_KEY):

Tool	Description
list_locations	List your organization's locations
create_location	Create a location (type determines the industry policy preset)
set_location_policy	Override or reset a location's policy
get_policy_history	Policy change audit log (append-only, newest first)
issue_token	Issue a digital QR ticket (code + wallet URL returned exactly once)
use_token	Mark a ticket as used after service
cancel_token	Cancel a ticket
export_data	Export all organization data as JSON (no lock-in)
list_webhooks	List outbound webhooks (never includes signing secrets)
create_webhook	Register a webhook — HMAC-SHA256 signed deliveries; secret returned exactly once
delete_webhook	Delete a webhook

Example prompts

• "Issue a queue ticket for my main counter and give me the wallet URL."
• "Verify this ticket: tok_... with code K7MP-..."
• "Make my EV charging location non-transferable." (it already is, by industry preset — the agent can check with get_location_policy)

Resources

• MCP setup (human-readable)
• ai.txt · llms.txt · llms-full.txt
• OpenAPI 3.1 specification
• TypeScript SDK @i-s3/rightos · Python SDK rightos-sdk
• MCP Registry (published): io.github.suomimasuda/rightos-mcp

License

MIT © I-S3 Inc.