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
Markdown
[](/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
- {
- "name": "uyaro",
- "owner": {
- "name": "Uyaro",
- "email": "hello@uyaro.com"
- },
- "metadata": {
- "description": "Official Uyaro plugins for Claude Code"
- },
- "plugins": [
- {
- "name": "uyaro",
- "source": "./",
- "description": "Operate the Uyaro POS platform via Claude — create customers, manage orders, check analytics, and more",
- "version": "0.2.1",
- "author": {
- "name": "Uyaro"
- },
- "homepage": "https://uyaro.in",
- "repository": "https://github.com/DineSynk/uyaro-mcp",
- "license": "MIT",
- "keywords": [
- "pos",
- "restaurant",
- "uyaro",
- "payments",
- "orders"
- ]
- }
- ]
- }
README.md · README · 100 lines
- # Uyaro — Claude Code Plugin
- 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.
- ## Install
- ### Claude Code (recommended)
- ```bash
- /plugin marketplace add DineSynk/uyaro-mcp
- /plugin install uyaro@uyaro
- ```
- Or via CLI:
- ```bash
- claude plugin marketplace add DineSynk/uyaro-mcp
- claude plugin install uyaro@uyaro
- ```
- ### Claude Desktop
- Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
- ```json
- {
- "mcpServers": {
- "uyaro": {
- "command": "npx",
- "args": ["-y", "@uyaro/mcp"]
- }
- }
- }
- ```
- ## First use
- After installing, open Claude Code and type `/uyaro`. Claude walks you through:
- 1. **Login** — calls the `login` MCP tool, shows a URL + code, waits for you to authenticate in the browser
- 2. **Explore** — use `get_docs` to understand any domain before operating it
- 3. **Run** — use `run_command` with CLI-style syntax
- ## Running as an agent, with a scoped key
- 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:
- ```json
- {
- "mcpServers": {
- "uyaro": {
- "command": "npx",
- "args": ["-y", "@uyaro/mcp"],
- "env": { "UYARO_API_KEY": "uyr_..." }
- }
- }
- }
- ```
- This needs `@uyaro/mcp` 0.2.1 or later; earlier versions ignore `UYARO_API_KEY`.
- 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.
- ## What you can do
- ```
- "Add 5 new customers to merchant abc123"
- "List all orders for store xyz today"
- "Credit 500 loyalty points to customer wallet wlt_abc"
- "Show me all terminals for merchant abc and their status"
- "Generate the end-of-day report for store xyz"
- "What products are in category 'Beverages'?"
- ```
- ## MCP tools
- | Tool | Description |
- |---|---|
- | `login` | Browser-based OAuth login. Shows URL + code. Token saved automatically. Not needed when `UYARO_API_KEY` is set. |
- | `run_command` | Run any CLI command: `"customers read --id=abc"`, `"orders create ..."` |
- | `get_docs` | Domain documentation — concepts, workflows, constraints. Call before operating a new domain. |
- | `list_commands` | All available commands grouped by domain, generated live from the API spec. |
- ## How it works
- The plugin bundles:
- - A `/uyaro` **skill** (`.claude-plugin` system) that guides Claude through the login → explore → operate flow
- - An **MCP server** (`@uyaro/mcp` on npm) that exposes the four tools above
- - The MCP server calls the Uyaro production API at `https://v2.api.kioskade.com`
- Tokens are stored at `~/.config/dinesynk/config.json`. Login once, use everywhere.
- ## Submit to official marketplace
- This plugin can be submitted to the official Anthropic marketplace via [claude.ai/settings/plugins/submit](https://claude.ai/settings/plugins/submit).
- ## Requirements
- - Claude Code 1.0.33+
- - Node.js 20+ (for the MCP server via npx)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.