# Rightos MCP

> Rightos MCP is a freemium MCP server for local services. Issue, verify and transfer QR tickets for queues, EV charging and pickup, no end-user PII. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://rightos.i-s3.com/software/rightos/docs/mcp
- **Repository:** https://github.com/suomimasuda/rightos-sdk/tree/HEAD/mcp
- **MCP Registry name:** io.github.suomimasuda/rightos-mcp
- **Categories:** local services, developer tools
- **Listing updated:** 2026-11-15

## About

Rightos works on the idea that a service point only needs to know that a valid right exists, never who holds it. This server wraps its API in 20 tools so an agent can issue a QR ticket, check a code, move a ticket to a new holder or read a location's policy without hand-written HTTP.

Seven or eight tools are public and work without a key, including plan listing, token lookup, verification, transfer and holder cancellation. The rest are operator tools that need an API key: creating locations, setting policies, issuing and cancelling tokens, exporting data and managing signed webhooks. A shared demo key is documented for trying it out.

Policies come as industry presets with country overlays for JP, US, GB, KR, TW, FR, DE, IT, ES and AU. Transfers re-key the token so the old code stops working. The project states it is not a taxi or ride-hailing dispatch service.

## Features

- **Ticket lifecycle:** Issue, use, cancel, verify and transfer QR tokens.
- **Public and operator tools:** Public lookups need no key; location and issuing tools need an operator key.
- **Policy presets:** Industry presets with country overlays, plus an append-only policy history.
- **Signed webhooks:** Register webhooks with HMAC-SHA256 signed deliveries.
- **Data export:** Export all organisation data as JSON.
- **Demo key:** A shared demo organisation key is documented for testing.

## Good for

- Issue a queue ticket for a counter and return its wallet URL
- Verify a presented ticket with its code
- Make an EV charging location non-transferable
- Register a webhook for successful verifications
- Export organisation data as JSON

## Install

### Claude Code (Terminal)

```sh
claude mcp add rightos-mcp --env RIGHTOS_API_KEY='<RIGHTOS_API_KEY>' -- npx -y @i-s3/rightos-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rightos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@i-s3/rightos-mcp"
      ],
      "env": {
        "RIGHTOS_API_KEY": "<RIGHTOS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rightos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@i-s3/rightos-mcp"
      ],
      "env": {
        "RIGHTOS_API_KEY": "<RIGHTOS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rightos-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@i-s3/rightos-mcp"
      ],
      "env": {
        "RIGHTOS_API_KEY": "<RIGHTOS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rightos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@i-s3/rightos-mcp"
      ],
      "env": {
        "RIGHTOS_API_KEY": "<RIGHTOS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rightos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@i-s3/rightos-mcp"
      ],
      "env": {
        "RIGHTOS_API_KEY": "<RIGHTOS_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_plans`: List pricing plans.
- `get_token`: Get a Right Token by ID without returning its secret code.
- `verify_token`: Verify a token with its verification code.
- `transfer_token`: Transfer a token by re-keying so the old code stops working.
- `holder_cancel_token`: Self-cancel a token as its current holder, policy permitting.
- `get_location_policy`: Get a location's effective policy.
- `list_policies`: List industry presets and country overlays.
- `get_location_queue`: Read a location's queue.
- `list_locations`: List your organisation's locations.
- `list_tokens`: List tokens.
- `create_location`: Create a location whose type sets the industry policy preset.
- `set_location_policy`: Override or reset a location's policy.
- `get_policy_history`: Policy change audit log, newest first.
- `issue_token`: Issue a digital QR ticket; code and wallet URL are returned once.
- `use_token`: Mark a ticket as used after service.
- `cancel_token`: Cancel a ticket.
- `export_data`: Export all organisation data as JSON.
- `list_webhooks`: List outbound webhooks.
- `create_webhook`: Register a signed webhook.
- `delete_webhook`: Delete a webhook.

## FAQ

### Does it collect personal data from end users?

The README says no names, phone numbers or birthdates are required from end users.

### Do I need an API key?

Public tools work without one. Operator tools need a key from a free registration.

### What does it cost?

A free tier covers 500 Right Tokens a month; paid plans are priced in yen, with Starter at 29,800 yen a year.

### What licence is it?

The package README states MIT.

### Is Rightos MCP free?

Rightos MCP has a free plan, with paid plans for more usage or features.

### How do I add Rightos MCP to Claude Code?

Run this command in your terminal: claude mcp add rightos-mcp --env RIGHTOS_API_KEY='<RIGHTOS_API_KEY>' -- npx -y @i-s3/rightos-mcp

### What are the best alternatives to Rightos MCP?

The closest alternatives to Rightos MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/rightos-mcp
