snaplii-cli

Snaplii AI Agent Cashback Payment

This is a skill of Agent-to-Merchant (A2M) payments — where AI agents complete transactions without checkout. Snaplii uses pre-funded gift cards as a payment rail, enabling instant, merchant-ready execution across 500+ brands.

How payment works

This skill spends only from the user's prepaid Snaplii Cash balance — no credit card is ever charged. The API key is scoped, revocable, and capped by a hard daily limit the user set in the app. A gift-card purchase charges the balance as soon as it runs. A bill payment, once sent, cannot be undone. A P2P transfer stays cancellable for about 5 minutes, then sends itself; transfers are also capped by a rolling 24-hour per-key transfer limit.

What this skill does and doesn't do: Snaplii buys a gift card and gives you its redemption code. It does not place orders on merchant or delivery apps and does not control a browser. After a purchase, hand the user the redemption code and tell them how to add it in the merchant app (e.g. Uber Eats / DoorDash → Payment → Add Gift Card). The user completes the order themselves.

Auth

When to connect

A user request to connect (including "install and connect") or to perform any Snaplii business task starts the authentication gate below. In confirmed Muse, also follow the Muse-led first-installation instructions in Meta Muse below. For other or unrecognized hosts, installation alone does not start connection. Updating, reinstalling, or merely reading/loading/copying the skill is not a connection request in any host. Report installation separately from connection. Help/version, local configuration, diagnostics, logout, and authentication setup remain available without a session; they are not business operations. If the user supplies a candidate bundle, keep its CLI and skill versions together; use its installer and retain the prerelease instead of replacing it from PyPI.

Authentication gate

1. Meta Muse uses the CLI path below. Other agents prefer available Snaplii MCP tools; otherwise use the CLI. Check snaplii config show for CLI operations or snaplii_config_show for MCP operations, using the same gateway as the task.
2. Every Snaplii business operation requires has_valid_token=true (the JSON boolean): browsing, balance, gift-card lists/details, quotes, purchases, cashback calculations, dashboards, all bill-pay and transfer actions, including history, status, and cancellation. Read-only operations are not exempt. An agent_id, an empty object, or other configuration fields do not establish authentication. If the field is missing, report an incompatible runtime and offer an update before continuing.
3. A valid session needs no init or connect. Otherwise follow the matching host branch below, then check state again before executing the requested task.
4. If the state includes muse_app_update, follow the instruction it contains.