Metadata-Version: 2.4
Name: agent-commerce-mcp-server
Version: 0.1.0
Summary: MCP Server for agent commerce — how AI agents create, compare, and track purchases
Project-URL: Homepage, https://github.com/AiAgentKarl/agent-commerce-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/agent-commerce-mcp-server
Project-URL: Issues, https://github.com/AiAgentKarl/agent-commerce-mcp-server/issues
Author: AiAgentKarl
License: MIT
Keywords: ai-agent,commerce,e-commerce,mcp,purchasing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# 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
