# Pyrimid Protocol

## What is this?
Onchain affiliate distribution protocol for AI agents on Base. Vendors list digital products, agents distribute them as affiliates, commissions settle instantly in USDC via smart contracts.

## How it works
- Vendors register onchain and list products with price + commission rate (0-50%)
- Agents register as affiliates (free, permissionless)
- When an agent's user buys a product, the CommissionRouter splits payment: 1% protocol, 0-50% affiliate, remainder to vendor
- Payments via x402 (HTTP-native payment standard by Coinbase)
- Settlement in USDC on Base, instant

## API
Base URL: https://pyrimid.ai

### Free endpoints (no auth)
- GET /api/v1/catalog — Browse all products (100+), filter by category, price, verified status
- GET /api/v1/stats — Protocol stats (volume, transactions, affiliates, vendors)
- GET /api/v1/stats?type=affiliate&id=af_xxx — Affiliate performance

### MCP Server
- POST /api/mcp — JSON-RPC 2.0 (Streamable HTTP)
- Tools: pyrimid_browse, pyrimid_buy, pyrimid_preview, pyrimid_categories, pyrimid_register_affiliate, pyrimid_vendor_stats, pyrimid_commission_check

## SDK
npm install @pyrimid/sdk

```javascript
import { PyrimidResolver } from '@pyrimid/sdk';
const resolver = new PyrimidResolver({ affiliateId: 'af_your_id' });
const product = await resolver.findProduct("trading signals");
```

## Contracts (Base Mainnet)
- Registry: 0x34e22fc20D457095e2814CdFfad1e42980EEC389
- Catalog: 0xC935d6B73034dDDb97AD2a1BbD2106F34A977908
- Router: 0xc949AEa380D7b7984806143ddbfE519B03ABd68B
- Treasury: 0x74A512F4f3F64aD479dEc4554a12855Ce943E12C

## Discovery
- MCP: https://pyrimid.ai/.well-known/mcp.json
- Agent Card: https://pyrimid.ai/agent.json
- Docs: https://pyrimid.ai/docs