Metadata-Version: 2.4
Name: monospay
Version: 0.8.0
Summary: Payments for AI agents — monospay.com
Project-URL: Homepage, https://monospay.com
Project-URL: Documentation, https://monospay.com/docs
Project-URL: Repository, https://github.com/monospay/monospay
Author-email: mono <hello@monospay.com>
License: MIT
Keywords: agents,ai,crewai,langchain,mcp,openai,payments
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1.0; extra == 'langchain'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == 'mcp'
Requires-Dist: pydantic>=2.0.0; extra == 'mcp'
Description-Content-Type: text/markdown

# monospay

[![PyPI](https://img.shields.io/pypi/v/monospay)](https://pypi.org/project/monospay/)
[![Python](https://img.shields.io/pypi/pyversions/monospay)](https://pypi.org/project/monospay/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![LangChain](https://img.shields.io/badge/LangChain-compatible-blue)
![CrewAI](https://img.shields.io/badge/CrewAI-compatible-blue)
![OpenAI](https://img.shields.io/badge/OpenAI-function_calling-blue)
![AutoGen](https://img.shields.io/badge/AutoGen-compatible-blue)
![Claude](https://img.shields.io/badge/Claude-MCP_server-blue)
![Cursor](https://img.shields.io/badge/Cursor-MCP_server-blue)
![Google ADK](https://img.shields.io/badge/Google_ADK-compatible-blue)

Your AI agent can send payments.  
`pip install monospay` · Your agent can pay.

---

## Get started

**Claude Desktop** — paste into your config, done:

```json
{
  "mcpServers": {
    "monospay": {
      "command": "npx",
      "args": ["-y", "monospay-mcp"],
      "env": { "MONO_API_KEY": "mono_live_..." }
    }
  }
}
```

Restart Claude Desktop. Ask: **"Check my monospay balance"**

Ready to move money? Add your private key:

```json
{
  "mcpServers": {
    "monospay": {
      "command": "npx",
      "args": ["-y", "monospay-mcp"],
      "env": {
        "MONO_API_KEY": "mono_live_...",
        "MONO_PRIVATE_KEY": "0x..."
      }
    }
  }
}
```

Then ask: **"Send $1.00 to 0x..."**

| With API key only | + Private Key |
|---|---|
| ✅ Check balance | ✅ Check balance |
| ✅ View transactions | ✅ View transactions |
| ✅ Set spending limits | ✅ Set spending limits |
| ❌ Send payments | ✅ **Send payments** |

**Claude Code** — one command:

```bash
claude mcp add monospay -e MONO_API_KEY=mono_live_... -- npx -y monospay-mcp
```

**Python SDK** — 3 lines of code:

```bash
pip install monospay
```

```python
from mono_sdk import MonoClient
client = MonoClient(api_key="mono_live_...")
client.signed_transfer(to_wallet="0x...", amount=1.00, private_key="0x...")
```

**Dashboard** — no code, manage everything in your browser:  
[monospay.com/dashboard](https://monospay.com/dashboard)

Get your API key at [monospay.com/dashboard](https://monospay.com/dashboard) → Agents → Issue API key.

---

## Why monospay

- **10 minutes to first payment** — paste config or pip install, your agent pays
- **Works with every AI framework** — LangChain, CrewAI, OpenAI, Claude, Cursor, Google ADK
- **Sub-cent transactions** — no $0.30 minimum like card networks
- **Agents don't need bank accounts** — just a wallet and a private key
- **You stay in control** — spending limits, daily budgets, transaction history

---

## Python SDK — Quickstart

```python
from mono_sdk import MonoClient

# Each agent has its own API key (from dashboard -> Agents -> Issue API key)
agent_a = MonoClient(api_key="mono_live_...")

# Agent A checks its balance
balance = agent_a.balance()
print(f"Budget: ${balance['available_usdc']}")  # -> Budget: $50.00

# Agent A pays Agent B
result = agent_a.signed_transfer(
    to_wallet="0x...",
    amount=1.50,
    private_key="0x...",
)
print(result["transaction_id"])
```

No wallets to manage. No gas. No KYC.

---

## 2-Agent Example

```python
from mono_sdk import MonoClient

agent_a = MonoClient(api_key="mono_live_A...")
agent_b = MonoClient(api_key="mono_live_B...")

# Agent A pays Agent B
agent_a.signed_transfer(
    to_wallet="0xAgentB_Wallet",
    amount=0.50,
    private_key="0xAgentA_Key",
)
print(f"A balance: ${agent_a.balance()['available_usdc']}")
print(f"B balance: ${agent_b.balance()['available_usdc']}")
```

---

## CLI — for developers

The CLI lets you inspect and manage your agents from the terminal.

```bash
mono balance          # Show your agent's balance
mono health           # Check gateway status
mono config show      # Show current config
```

---

## LangChain

```bash
pip install "monospay[langchain]"
```

```python
from mono_sdk.langchain_tools import MonoToolkit

toolkit = MonoToolkit(api_key="mono_live_...")
tools   = toolkit.get_tools()
```

---

## OpenAI Function Calling

```python
from mono_sdk.openai_functions import get_mono_tools, handle_tool_call

tools = get_mono_tools()
# Pass tools to your OpenAI chat completion
```

---

## Error handling

```python
from mono_sdk.errors import InsufficientBalanceError, AuthenticationError

try:
    agent_a.signed_transfer(to_wallet="0x...", amount=999.00, private_key="0x...")
except InsufficientBalanceError:
    print("Out of budget — top up at monospay.com/dashboard")
except AuthenticationError:
    print("Invalid key — run: mono init")
```

---

## Links

- Dashboard · [monospay.com](https://monospay.com)
- Docs · [monospay.com/docs](https://monospay.com/docs)
- PyPI · [monospay](https://pypi.org/project/monospay/)
