{
  "markdown": "# RightOS SDKs\n\n[![ci](https://github.com/suomimasuda/rightos-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/suomimasuda/rightos-sdk/actions/workflows/ci.yml)\n\nOfficial SDKs for [RightOS](https://rightos.i-s3.com/software/rightos) — privacy-preserving rights verification infrastructure by [I-S3](https://www.i-s3.com/) (Japan).\n\nRightOS 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.\n\n> RightOS is not a taxi or ride-hailing service. It does not arrange vehicles, set fares, assign drivers, or broker dispatch.\n\n## SDKs\n\n| Layer | Question | Packages |\n|---|---|---|\n| RightOS | What may be done? | [`@i-s3/rightos`](https://www.npmjs.com/package/@i-s3/rightos) · [`@i-s3/rightos-mcp`](https://www.npmjs.com/package/@i-s3/rightos-mcp) |\n| RightFlow | What should happen next? | [`@i-s3/rightflow`](https://www.npmjs.com/package/@i-s3/rightflow) · [`@i-s3/rightflow-mcp`](https://www.npmjs.com/package/@i-s3/rightflow-mcp) |\n| Execution | How is it done? | your systems |\n\nRightOS / RightFlow SDKs install via package managers (or download the thin client files).\n\n| Language | Package | Single file | Requirements |\n|---|---|---|---|\n| TypeScript | [`typescript/`](./typescript) — [`@i-s3/rightos`](https://www.npmjs.com/package/@i-s3/rightos) | [rightos.ts](https://rightos.i-s3.com/sdk/rightos.ts) | Node.js ≥ 18 or a modern browser |\n| Python | [`python/`](./python) — [`rightos-sdk`](https://pypi.org/project/rightos-sdk/) | [rightos.py](https://rightos.i-s3.com/sdk/rightos.py) | Python ≥ 3.9, standard library only |\n| TypeScript | [`rightflow/`](./rightflow) — [`@i-s3/rightflow`](https://www.npmjs.com/package/@i-s3/rightflow) | [rightflow.ts](https://rightos.i-s3.com/sdk/rightflow.ts) | Node.js ≥ 18 or a modern browser |\n\n> RightFlow is coordination beside RightOS — not a redesign. No money, marketplace, dispatch, or robot control in the core.\n\n## MCP servers (for AI agents)\n\n[`mcp/`](./mcp) — `@i-s3/rightos-mcp`: rights tools (issue / verify / transfer).\n\n[`rightflow-mcp/`](./rightflow-mcp) — `@i-s3/rightflow-mcp`: coordination tools (tasks / actors / proposals / transitions). Separate from RightOS MCP.\n\n```json\n{\n  \"mcpServers\": {\n    \"rightos\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@i-s3/rightos-mcp\"],\n      \"env\": { \"RIGHTOS_API_KEY\": \"rk_live_...\" }\n    },\n    \"rightflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@i-s3/rightflow-mcp\"],\n      \"env\": { \"RIGHTOS_API_KEY\": \"rk_live_...\" }\n    }\n  }\n}\n```\n\n## Quick example (TypeScript)\n\n```ts\nimport { RightOS } from \"@i-s3/rightos\";\n\nconst client = new RightOS({ apiKey: \"rk_live_...\" });\nconst [location] = await client.listLocations();\nconst issued = await client.issueToken({ locationId: location.id, title: \"Queue ticket\" });\n// Hand issued.walletUrl (QR page) to your customer\nconst outcome = await RightOS.verify(issued.token.id, issued.verificationCode);\n// outcome.result === \"success\"\n```\n\n## Quick example (Python)\n\n```python\nfrom rightos import RightOS\n\nclient = RightOS(api_key=\"rk_live_...\")\nlocation = client.list_locations()[0]\nissued = client.issue_token(location_id=location[\"id\"], title=\"Queue ticket\")\noutcome = RightOS().verify_token(issued[\"token\"][\"id\"], issued[\"verificationCode\"])\n# outcome[\"result\"] == \"success\"\n```\n\n## Resources\n\n- [RightOS docs](https://rightos.i-s3.com/software/rightos/docs)\n- [RightFlow docs](https://rightos.i-s3.com/software/rightflow/docs)\n- [OpenAPI 3.1 (RightOS)](https://rightos.i-s3.com/openapi.json)\n- [OpenAPI (RightFlow)](https://rightos.i-s3.com/rightflow-openapi.json)\n- [Full documentation for AI agents (llms-full.txt)](https://rightos.i-s3.com/llms-full.txt)\n- [Pricing](https://rightos.i-s3.com/software/rightos/pricing) — globally uniform, free tier available, no credit card required\n- Try the live demo without registration: shared demo key `rk_demo_00000000000000000000`\n\n## Privacy & security design\n\n- The verification code is handed to the holder exactly once; the server stores only its SHA-256 hash.\n- Transfers use re-keying: a new code is issued and the old one is invalidated immediately.\n- QR codes contain only the `tokenId` and `verificationCode` — no personal data.\n- Paid transfers and auctions are not offered.\n\n## License\n\nMIT © I-S3 Inc.\n",
  "bytes": 4425,
  "sha": "44071ccffed62f3251f261af398f1d44e306b6e027237015de223a94ede60b7f",
  "repo_slug": "suomimasuda/rightos-sdk",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_suomimasuda_rightos_mcp_a5771086/readme"
}