Snaplii-Inc/agent-to-merchant-payments
Snaplii-Inc/agent-to-merchant-paymentsPayments are broken for AI agents. Snaplii unlocks real-world commerce with a safe, tokenized payment layer — powered by 500+ merchant gift cards — and is the only one that actually saves you money (up to 10% per transaction), on top of any existing deals or promotions.
From the README
Agent-to-Merchant Payments by Snaplii
Payments are broken for AI agents.
Snaplii unlocks real-world commerce with a safe, tokenized payment layer — powered by 500+ merchant gift cards — and is the only one that actually saves you money (up to 10% per transaction), on top of any existing deals or promotions.
The Problem
AI agents can already:
- decide what to buy
- compare options
- navigate merchant platforms
But they still can’t safely pay. Payments require trust, compliance, and risk control — things AI agents are not designed to handle.
Giving agents access to cards is not a solution. It’s a risk.
The Solution
Snaplii introduces a new model: User → Agent → Snaplii → Merchant
- Users fund Snaplii
- Agents operate within a controlled boundary
- Each transaction is pre-funded, isolated, and non-reusable
No shared credentials. No persistent risk.
In addition, Snaplii embeds value directly into the payment layer —
transactions can save up to 10% and stack seamlessly with existing merchant deals and promotions.
Table of Contents
- Requirements
- Quick Start
- Components
- CLI Commands
- Claude Desktop Setup MCP Server
- Claude Code Skill
- Troubleshooting
- Security
- License
Requirements
- Python 3.10+
CLI works on Python 3.9+, but the MCP server requires Python 3.10+. - Git
- Snaplii Mobile App
Required to generate your API key.
Mac users: check your Python version
python3 --version
If your Python version is below 3.10, install Python via Homebrew:
brew install python@3.12
Then use python3.12 and pip3.12 instead of python3 / pip3 in the steps below.
Quick Start
1. Get Your API Key via Snaplii App
Before using the CLI or configuring your AI agent, generate a secure API key from the Snaplii mobile app:
- Download the Snaplii app for iOS or Android.
- Register an account and bind a payment method to load your Snaplii Cash balance.
- In the app, go to More → Payment Methods → AI Payment Management.
- Tap + New API Key.
- Set a name, define the permission scope, and set a hard spending limit.
- Example scopes: Read-only or Purchase
- Copy the API key.
- Format:
snp_sk_live_... - Keep it safe — it will only be shown once.
- Format:
2. Get the Code
git clone
cd agent-to-merchant-payments
3. Install the CLI
pipx is the smoothest path. It installs the CLI in its own isolated environment and puts the snaplii executable on your PATH.
macOS
brew install pipx
pipx ens