Summary

This project addresses the critical gap in AI agent capabilities: secure and compliant payments. It provides a tokenized payment layer, powered by over 500 merchant gift cards, enabling AI agents to conduct real-world commerce safely. The solution offers significant benefits, including up to 10% transaction savings that stack with existing deals, making it a valuable tool for developers building transactional AI agents.

How It Works

Snaplii introduces a novel payment architecture: User → Agent → Snaplii → Merchant. Users fund a Snaplii Cash balance, which AI agents then utilize within strictly controlled boundaries. Each transaction is pre-funded, isolated, and non-reusable, eliminating the risks associated with shared credentials or persistent agent access to payment methods. This approach embeds value directly into the payment layer, facilitating cost savings and seamless integration with existing merchant promotions.

Quick Start & Requirements

• Requirements: Python 3.10+ (for MCP server), Git, Snaplii Mobile App (iOS/Android) for API key generation and funding.
• Installation: Clone the repository, install the CLI (pipx install -e ./snaplii-cli), and authenticate (snaplii init) using an API key obtained from the mobile app.
• Usage: Example command: snaplii purchase --item-id CB...-CT... --price 50 --prov ON.
• Claude Desktop: Requires installing the MCP server (pip3 install "mcp[cli]") and configuring claude_desktop_config.json with absolute paths.
• Links: Snaplii App (iOS/Android).

Highlighted Details

• Cost Savings: Achieves up to 10% savings per transaction, which can be combined with existing merchant discounts.
• Security: Employs tokenized payments, isolated pre-funded transactions, scoped API keys (read-only or purchase), and user-defined spending limits via the mobile app.
• AI Integration: Features components for seamless integration with AI assistants like Claude Desktop (via MCP Server) and Claude Code Skills.
• Ecosystem: Leverages a network of over 500 merchant gift cards for transaction processing.

Maintenance & Community

No specific details regarding maintainers, sponsorships, or community channels (e.g., Discord, Slack) are provided in the README.

Licensing & Compatibility

• License: Apache License 2.0.
• Compatibility: The Apache 2.0 license is permissive and generally suitable for commercial use and integration into closed-source projects.

Limitations & Caveats

Setup requires a mobile app for essential functions like API key generation and account funding. Integration with Claude Desktop involves complex configuration, including specifying absolute paths for Python interpreters and server scripts. The system's functionality is dependent on maintaining a pre-funded Snaplii Cash balance.