# Agent Commerce MCP Server

MCP Server for agent commerce — a protocol for how AI agents create, compare, and track purchases. Enables structured buying workflows with offer comparison and merchant verification.

## Features

- **Purchase Intents** — Create structured purchase requests with budget constraints
- **Offer Comparison** — Compare offers from multiple sources side by side
- **Purchase Tracking** — Track status from intent to delivery
- **Merchant Verification** — Build reliability scores based on order history

## Installation

```bash
pip install agent-commerce-mcp-server
```

## Usage with Claude Code

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "agent-commerce": {
      "command": "uvx",
      "args": ["agent-commerce-mcp-server"]
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `create_purchase_intent` | Create a structured purchase request |
| `compare_offers` | Compare offers from multiple sources |
| `track_purchase` | Track or update purchase status |
| `list_purchases` | List purchase history with optional filters |
| `verify_merchant` | Check or update merchant reliability score |

## Purchase Flow

1. `create_purchase_intent` — Define what you want to buy
2. `compare_offers` — Add and compare offers from different merchants
3. `verify_merchant` — Check merchant reliability before ordering
4. `track_purchase` — Update status as the order progresses

## Data Storage

All purchase data is stored locally in SQLite at `~/.agent-commerce/purchases.db`.

## License

MIT
