Skip to content
Back to search

uyaro

MarketplaceWorks with Claude CodeGitHub

Uyaro POS MCP server and CLI (@uyaro/mcp)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dinesynk--uyaro-mcp/badge.svg)](/listings/dinesynk--uyaro-mcp)

HTML

<a href="/listings/dinesynk--uyaro-mcp"><img src="/api/listings/dinesynk--uyaro-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code (recommended)

/plugin marketplace add DineSynk/uyaro-mcp
/plugin install uyaro@uyaro

Or via CLI:

claude plugin marketplace add DineSynk/uyaro-mcp
claude plugin install uyaro@uyaro

Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

{
    "mcpServers": {
        "uyaro": {
            "command": "npx",
            "args": ["-y", "@uyaro/mcp"]
        }
    }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 31 lines
  1. {
  2. "name": "uyaro",
  3. "owner": {
  4. "name": "Uyaro",
  5. "email": "hello@uyaro.com"
  6. },
  7. "metadata": {
  8. "description": "Official Uyaro plugins for Claude Code"
  9. },
  10. "plugins": [
  11. {
  12. "name": "uyaro",
  13. "source": "./",
  14. "description": "Operate the Uyaro POS platform via Claude — create customers, manage orders, check analytics, and more",
  15. "version": "0.2.1",
  16. "author": {
  17. "name": "Uyaro"
  18. },
  19. "homepage": "https://uyaro.in",
  20. "repository": "https://github.com/DineSynk/uyaro-mcp",
  21. "license": "MIT",
  22. "keywords": [
  23. "pos",
  24. "restaurant",
  25. "uyaro",
  26. "payments",
  27. "orders"
  28. ]
  29. }
  30. ]
  31. }
README.md · README · 100 lines
  1. # Uyaro — Claude Code Plugin
  2. Operate the [Uyaro](https://uyaro.in) restaurant POS platform from Claude. Create customers, manage orders, check analytics, handle payments, and more — all via natural language.
  3. ## Install
  4. ### Claude Code (recommended)
  5. ```bash
  6. /plugin marketplace add DineSynk/uyaro-mcp
  7. /plugin install uyaro@uyaro
  8. ```
  9. Or via CLI:
  10. ```bash
  11. claude plugin marketplace add DineSynk/uyaro-mcp
  12. claude plugin install uyaro@uyaro
  13. ```
  14. ### Claude Desktop
  15. Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
  16. ```json
  17. {
  18. "mcpServers": {
  19. "uyaro": {
  20. "command": "npx",
  21. "args": ["-y", "@uyaro/mcp"]
  22. }
  23. }
  24. }
  25. ```
  26. ## First use
  27. After installing, open Claude Code and type `/uyaro`. Claude walks you through:
  28. 1. **Login** — calls the `login` MCP tool, shows a URL + code, waits for you to authenticate in the browser
  29. 2. **Explore** — use `get_docs` to understand any domain before operating it
  30. 3. **Run** — use `run_command` with CLI-style syntax
  31. ## Running as an agent, with a scoped key
  32. A merchant owner can issue a service account key that is limited to chosen capabilities and optionally to chosen stores. Give it to the MCP server in the environment and no browser login is needed:
  33. ```json
  34. {
  35. "mcpServers": {
  36. "uyaro": {
  37. "command": "npx",
  38. "args": ["-y", "@uyaro/mcp"],
  39. "env": { "UYARO_API_KEY": "uyr_..." }
  40. }
  41. }
  42. }
  43. ```
  44. This needs `@uyaro/mcp` 0.2.1 or later; earlier versions ignore `UYARO_API_KEY`.
  45. The key takes the place of a saved login while it is set. It is read from the environment only, never written to disk, and a command outside what the owner granted is refused by the API.
  46. ## What you can do
  47. ```
  48. "Add 5 new customers to merchant abc123"
  49. "List all orders for store xyz today"
  50. "Credit 500 loyalty points to customer wallet wlt_abc"
  51. "Show me all terminals for merchant abc and their status"
  52. "Generate the end-of-day report for store xyz"
  53. "What products are in category 'Beverages'?"
  54. ```
  55. ## MCP tools
  56. | Tool | Description |
  57. |---|---|
  58. | `login` | Browser-based OAuth login. Shows URL + code. Token saved automatically. Not needed when `UYARO_API_KEY` is set. |
  59. | `run_command` | Run any CLI command: `"customers read --id=abc"`, `"orders create ..."` |
  60. | `get_docs` | Domain documentation — concepts, workflows, constraints. Call before operating a new domain. |
  61. | `list_commands` | All available commands grouped by domain, generated live from the API spec. |
  62. ## How it works
  63. The plugin bundles:
  64. - A `/uyaro` **skill** (`.claude-plugin` system) that guides Claude through the login → explore → operate flow
  65. - An **MCP server** (`@uyaro/mcp` on npm) that exposes the four tools above
  66. - The MCP server calls the Uyaro production API at `https://v2.api.kioskade.com`
  67. Tokens are stored at `~/.config/dinesynk/config.json`. Login once, use everywhere.
  68. ## Submit to official marketplace
  69. This plugin can be submitted to the official Anthropic marketplace via [claude.ai/settings/plugins/submit](https://claude.ai/settings/plugins/submit).
  70. ## Requirements
  71. - Claude Code 1.0.33+
  72. - Node.js 20+ (for the MCP server via npx)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.