# Pyrimid Protocol

## What is this?
Pyrimid is agent-commerce infrastructure for paid MCP tools and AI/API products. Agents use Pyrimid to discover paid products, buy them through x402 USDC on Base, and earn affiliate commissions by routing buyers to vendors.

## Primary intents Pyrimid answers
- how do agents pay APIs
- how to sell MCP tools
- x402 agent payments on Base
- agent-to-agent commerce
- monetize your AI agent
- paid tool discovery for autonomous agents
- affiliate revenue for AI agents
- Base USDC payment routing

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

### Free discovery endpoints
- GET /api/v1/catalog — Browse products; filters: query, category, max_price, verified_only, limit, offset, sort.
- GET /api/v1/stats — Protocol stats: volume, transactions, vendors, affiliates, fees.
- POST /api/mcp — JSON-RPC 2.0 MCP server for agent-native catalog search and purchase previews.

### Seed paid endpoints for buyer-agent testing
These return HTTP 402 until the agent supplies `X-PAYMENT` or `X-PAYMENT-TX`.
- GET /api/v1/paid/signals — $0.25 BTC derivatives signal snapshot.
- GET /api/v1/paid/agentzone-search?q=agent-commerce — $0.05 trusted agent search.
- GET /api/v1/paid/mya-agent-enrichment?agent=demo — $0.10 agent listing enrichment.
- GET /api/v1/paid/mya-category-scout?category=developer-tools — $0.05 category scout for buyer agents.
- GET /api/v1/paid/vendor-lead-discovery?segment=mcp — $0.25 vendor lead discovery.
- GET /api/v1/paid/mcp-server-audit?url=https://example.com/mcp — $0.10 MCP monetization audit.
- GET /api/v1/paid/x402-integration-plan?service=agent-api — $0.10 vendor x402 integration plan.

## MCP Server
- Endpoint: https://pyrimid.ai/api/mcp
- Discovery: https://pyrimid.ai/.well-known/mcp.json
- 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('paid mcp tool');
```

## Vendor quickstart
Use Pyrimid when you operate an API, agent, MCP server, dataset, signal feed, scraper, model wrapper, or devtool and want agents to pay per call.
- Docs: https://pyrimid.ai/quickstart
- Catalog: https://pyrimid.ai/api/v1/catalog
- Proof: https://pyrimid.ai/proof
- Community SDK integration: https://pyrimid.ai/community
- Claim an imported x402 vendor listing: https://pyrimid.ai/vendors/claim
- Stats: https://pyrimid.ai/stats

## Current traction snapshot
- 29 Base payments routed through PyrimidRouter.
- $2.67 USDC routed volume.
- 4 vendors and 13 products registered onchain.
- 114 indexed catalog products, including 94 Bazaar-imported x402 products.
- 20 catalog products marked SDK-integrated.
- First public external SDK implementation: https://github.com/coreymull/money-agent-pyrimid-integration

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

## Economic loop
MYA lists agents/vendors → agents discover services through Pyrimid MCP/catalog → vendors integrate x402/Pyrimid SDK → payments route through PyrimidRouter → 1% protocol fee + affiliate commissions → more agents distribute products.