@yian-uk/cli
v0.1.0
Published
yian: the YIAN card restoration workshop from the terminal, and an MCP server for Claude Code and Codex.
Maintainers
Readme
@yian-uk/cli
yian — the YIAN card restoration workshop from the terminal, and an MCP server for Claude Code,
Codex and Cursor. For YIAN staff: it needs a staff API key from https://yian.uk/staff/keys.
npx @yian-uk/cli login # paste your key (stored in ~/.config/yian/credentials.json, 0600)
npx @yian-uk/cli queues # what's waiting
npx @yian-uk/cli owes-us --older-than 72
npx @yian-uk/cli quote RQ-261027-AB12C
npx @yian-uk/cli price RQ-261027-AB12C 30 --message-file msg.txt # preview, then asks
npx @yian-uk/cli help # everythingEvery write shows a preview first and runs only after a yes (interactive prompt, --yes for
internal changes and payment records, --yes --send for anything the customer sees). Without a
terminal it prints the preview and a yian confirm <tool> <confirmation> line to run once a person
has approved — that is how agents use it.
MCP
claude mcp add yian -- npx -y @yian-uk/cli mcpyian mcp is a stdio MCP server that forwards to https://yian.uk/mcp with your key. You can also
point an HTTP MCP client straight at https://yian.uk/mcp with Authorization: Bearer <key>.
Environment: YIAN_API_KEY, YIAN_BASE_URL (default https://yian.uk), YIAN_CONFIG_DIR.
Exit codes: 0 ok · 2 input · 3 not signed in · 4 not allowed or needs approval · 5 server.
