@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 SDKrightos-sdk - MCP Registry (published):
io.github.suomimasuda/rightos-mcp
License
MIT © I-S3 Inc.