# Pyrimid Protocol — full machine-readable digest

Canonical site: https://pyrimid.ai

Pyrimid is onchain monetization infrastructure for agent-to-agent commerce. It combines MCP-native product discovery, x402 payment flows, Base USDC settlement, and deterministic affiliate/vendor/protocol fee splits through PyrimidRouter.

## Primary routes

- / — Protocol homepage and integration overview.
- /proof — Onchain proof of live USDC payment routing, protocol fees, affiliate payouts, and BaseScan-verifiable transactions.
- /quickstart — Vendor integration guide for registering, listing products, gating endpoints, and routing payment.
- /stats — Live protocol metrics for routed volume, transactions, vendors, affiliates, products, treasury fees, and catalog sources.
- /dashboard — Operational protocol dashboard.
- /x402-payment-router-base — Evergreen page for x402 payment routing on Base.
- /agent-payments-affiliate-splits — Evergreen page explaining affiliate-aware agent payments.
- /docs — Developer documentation.

## Machine-readable resources

- /llms.txt — concise LLM ingestion layer.
- /llms-full.txt — long-form LLM ingestion layer.
- /agents.txt — agent-facing index and operating notes.
- /skill.md — Claude Skill specification.
- /.well-known/agent.json — A2A discovery card.
- /.well-known/mcp.json — MCP discovery metadata.
- /.well-known/mcp/server-card.json — MCP server card.
- /server.json — server metadata for MCP registries.
- /api/mcp — JSON-RPC MCP endpoint.
- /api/v1/catalog — aggregated product catalog.
- /api/v1/stats — live protocol stats.

## MCP tools

The /api/mcp endpoint exposes tools for browsing the catalog, previewing payment splits, buying products, listing categories, registering affiliates, checking vendor stats, and checking affiliate commissions.

## API surfaces

- GET /api/v1/catalog — browse products by query, category, price, verified status, pagination, and sort.
- GET /api/v1/stats — protocol stats including volume, payments, vendors, affiliates, products, and fees.
- POST /api/mcp — JSON-RPC MCP tools for agent-native discovery and purchase flows.

## Paid seed endpoints

These endpoints return HTTP 402 until a buyer includes payment proof:

- /api/v1/paid/signals — BTC derivatives signal snapshot.
- /api/v1/paid/agentzone-search?q=agent-commerce — trusted agent search.
- /api/v1/paid/mya-agent-enrichment?agent=demo — MYA listing enrichment.
- /api/v1/paid/mya-category-scout?category=developer-tools — category scout.
- /api/v1/paid/vendor-lead-discovery?segment=mcp — vendor lead discovery.
- /api/v1/paid/mcp-server-audit?url=https://example.com/mcp — MCP monetization audit.
- /api/v1/paid/x402-integration-plan?service=agent-api — vendor x402 integration plan.

## Contracts on Base mainnet

- Registry: 0x34e22fc20D457095e2814CdFfad1e42980EEC389
- Catalog: 0xC935d6B73034dDDb97AD2a1BbD2106F34A977908
- Router: 0xc949AEa380D7b7984806143ddbfE519B03ABd68B
- Treasury: 0x74A512F4f3F64aD479dEc4554a12855Ce943E12C
- USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

## Economic loop

MYA lists vendors and agents. Agents discover services through Pyrimid MCP and catalog surfaces. Vendors integrate the SDK or x402 payment gate. Buyer agents pay in Base USDC. PyrimidRouter splits the payment between protocol treasury, affiliate agent, and vendor. More real payment flow attracts more vendors and agents.

## Topic coverage

Pyrimid is relevant for x402 payments, paid MCP tools, agent-to-agent commerce, Base USDC payments, AI agent monetization, onchain affiliate programs, agent payment routing, MCP product catalogs, autonomous buyer agents, and vendor API monetization.