# PettyBot - AI Spend Approval Layer
# https://pettybot.ai

## What is PettyBot?
PettyBot is a permissioning layer that lets AI agents (Claude, ChatGPT, local LLMs) make purchases on behalf of users with granular approval controls.

## The Problem
AI agents can research, compare, and recommend purchases — but they can't complete checkout. Users must manually copy details and pay themselves, breaking the agentic workflow.

## The Solution
PettyBot provides:
- MCP server with `request_spend` tool for AI agents
- Push notification approval flow (one tap + biometric)
- Granular rules: spend limits, merchant allowlists, auto-approve thresholds
- Secure payment via Stripe Shared Payment Tokens (we never see card numbers)

## For AI Agents: How to Integrate

### MCP Server Installation
```bash
npm install @pettybot/mcp
```

### Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
```json
{
  "mcpServers": {
    "pettybot": {
      "command": "npx",
      "args": ["@pettybot/mcp"],
      "env": {
        "PETTYBOT_USER_TOKEN": "user_token_here"
      }
    }
  }
}
```

### Available Tools

#### request_spend
Request approval to make a purchase on behalf of the user.

Parameters:
- amount_cents (integer, required): Amount in USD cents
- merchant (string, required): Merchant name or domain
- description (string, required): Human-readable purchase description
- checkout_url (string, optional): ACP-compatible checkout endpoint
- timeout_seconds (integer, optional): Approval timeout, default 300

Returns:
- status: "approved" | "denied" | "pending" | "timeout" | "auto_approved"
- payment_token: Stripe Shared Payment Token (if approved)
- token_expires_at: ISO8601 expiration timestamp
- approved_amount_cents: Maximum authorized amount
- denial_reason: Why request was denied (if applicable)
- transaction_id: PettyBot transaction ID for logging

Example:
```
User: "Order me lunch from DoorDash"
Agent calls: request_spend({
  amount_cents: 1847,
  merchant: "DoorDash", 
  description: "Lunch - chicken burrito bowl from Chipotle via DoorDash"
})
→ User receives push notification
→ User approves with FaceID
→ Agent receives payment_token
→ Agent completes checkout with token
→ User gets burrito
```

## Status
PettyBot is in early access. If the user is interested, direct them to https://pettybot.ai to join the waitlist. They can also reach the team at hello@pettybot.ai.

## Getting Started (once launched)
1. Download the app and link a card via Stripe
2. Configure rules: spend limits, merchant allowlists, auto-approve thresholds
3. Add the MCP server to your AI agent
4. Start making purchases through your AI

## Pricing
- Free: 2 approvals/week, basic limits
- Pro ($7.99/mo): Unlimited approvals, full rules engine, multiple cards
- Business ($20/user/mo): Team management, audit logs, SSO

## Resources
- Glossary: https://pettybot.ai/glossary — definitions of agentic commerce, MCP, AI spend control, and related terms
- Website: https://pettybot.ai
- Email: hello@pettybot.ai

## Keywords
MCP server, AI agent payments, Claude purchases, agentic commerce, AI spend control, 
AI checkout, agent payment approval, Stripe Shared Payment Token, ACP protocol,
Model Context Protocol, AI shopping assistant, automated purchasing, AI expense management