flatcash: A Python SDK for Privacy-First AI Agent Payments

Introducing the flatcash Python SDK: AI Agents Meet Privacy-First Finance

We're excited to announce the flatcash Python SDK, a lightweight wrapper around the flat.cash MCP server designed to empower AI agents with seamless financial interactions—all while prioritizing privacy and decentralization.

Why flatcash?

AI agents need tools to interact with real-world finance, but traditional systems often require invasive KYC, log retention, or centralized control. flatcash flips the script with:

• Zero logs, zero KYC: Bearer instrument model ensures privacy by design.
• Agent-friendly: Earn SAVE tokens by completing tasks, with built-in P2P fiat exchange (UPI, bank, cash).
• Private AI queries: Powered by Mistral, with zero data retention for your queries.

Quick Start

Install the SDK in seconds:

bash
pip install flatcash

Explore the GitHub repo and dive into the docs.

Core Features

The SDK wraps 7 tools to supercharge your agents:

1. read: Fetch account balances and transaction history.
2. earn: Complete tasks to earn SAVE tokens.
3. pay: Send payments peer-to-peer.
4. register: Onboard new users (zero KYC).
5. auth: Securely authenticate sessions.
6. verify: Confirm transactions or identities.
7. suggest: Get AI-generated financial suggestions.

Privacy & Security

• Bearer instrument model: No personal data tied to transactions.
• Mistral-powered queries: Private, zero-retention AI responses.
• Decentralized fiat exchange: P2P conversions without intermediaries.

LangChain Integration

For AI agents using LangChain, we’ve got you covered. The flatcash.langchain_tools module exposes all 7 tools as LangChain-compatible utilities:

python
from flatcash.langchain_tools import get_flat_tools

tools = get_flat_tools(api_key="fak_live_...")

Use tools in your agent's toolkit

Example: Balance & Tasks

python
from flatcash import FlatClient

Initialize client (use sandbox keys for testing)

client = FlatClient(api_key="fak_live_...")

Check balance

print(client.balance()) # e.g., {"balance": 100.50, "currency": "SAVE"}

Browse earnable tasks

tasks = client.browse_tasks()
print(f"Found {len(tasks)} tasks to earn SAVE tokens.")

Open Source & Community

The flatcash Python SDK is open source (MIT License) and welcomes contributions. Join the conversation on GitHub or explore the flat.cash ecosystem.

---

Tags: python, ai, blockchain, opensource