Pyrimid Protocol

Pyrimid Protocol

Agent-commerce infra for paid MCP tools and x402 AI/API products on Base.

Website · Quickstart · MCP Server · SDK on npm · Contracts

---

What is Pyrimid?

Pyrimid is a protocol where vendors sell paid MCP tools / AI APIs, agents discover and buy them via x402, and commissions settle instantly in USDC via smart contracts on Base.

Agent discovers a product → purchases via x402 → smart contract splits payment:

1% → Protocol treasury 0–50% → Affiliate agent (set by vendor) Remainder → Vendor

No affiliate? Vendor gets 99%. Vendors only pay for distribution that drives real sales. One layer only — no MLM, no pyramids. Just clean, transparent commission splitting onchain.

---

Why Pyrimid?

---

Quick Start

Install the SDK

npm install @pyrimid/sdk

For Agents — Find & Recommend Products

import { PyrimidResolver } from '@pyrimid/sdk';

const resolver = new PyrimidResolver({ affiliateId: 'af_your_id' });

// Search the catalog const product = await resolver.findProduct("trading signals");

// Purchase with x402 payment (auto-splits commissions) if (product) { const receipt = await resolver.purchase(product, agentWallet); console.log(Earned: $${receipt.affiliate_earned / 1_000_000} USDC); }

For Vendors — List Your Product

import { pyrimidMiddleware } from '@pyrimid/sdk';

// 10 lines to activate affiliate distribution app.use(pyrimidMiddleware({ vendorId: 'vn_your_id', products: { '/api/signals/latest': { productId: 'signals_latest', price: 250_000, // $0.25 USDC affiliateBps: 1000, // 10% to affiliates }, }, }));

For Frameworks — Embed as Default Layer

import { createPyrimidMcpServer } from '@pyrimid/sdk';

// Deploy an MCP server — agents connect, browse, buy const server = createPyrimidMcpServer({ affiliateId: 'af_your_id', serverName: 'my-recommender', });

---

Live buyer-agent test surfaces

Call these without payment to receive HTTP 402 with x402 accepts[] metadata. Retry with X-PAYMENT or X-PAYMENT-TX after payment.

Three Integration Paths

---

Smart Contracts (Base Mainnet)

All contracts are deployed and verified on Base. ERC-1967 upgradeable proxy pattern.

---

API Reference

The Pyrimid API is free to read, rate-limited (60 req/min), and returns JSON.

MCP Tools

---

Architecture

pyrimid/

├── app/ # Next.js 15 (Vercel, region: bom1) │ ├── page.tsx # Landing page │ ├── dashboard/ # Protocol dashboard │ └── api/ │ ├── v1/catalog/ # Aggregated product catalog │ ├── v1/paid/ # Seed x402 paid endpoints │ ├── v1/stats/ # Protocol & affiliate analytics │ └── mcp/ # MCP JSON-RPC endpoint ├── sdk/ # @pyrimid/sdk (published to npm) │ └── src/ │ ├── resolver.ts # PyrimidResolver — search, purchase, stats │ ├── mcp-server.ts # MCP server factory │ ├── middleware.ts # Vendor payment middleware + calculateSplit() │ └── types.ts # ABIs, addresses, interfaces ├── subgraph/ # The Graph indexer (Base) │ ├── schema.graphql # PaymentRouted, Affiliate, Vendor entities │ ├── subgraph.yaml # 4 data sources │ └── src/mapping.ts # Event handlers ├── middleware.ts # Edge rate limiting (60/min API, 120/min MCP) └── public/docs/ # Developer documentation

---

Development

# Clone & install

git clone https://github.com/pyrimid/protocol.git cd protocol npm install

Run locally

cp .env.example .env npm run dev

SDK development

cd sdk npm run build # TypeScript → dist/ npm run dev # Watch mode

Deploy

# Website + API

npx vercel --prod

SDK to npm

cd sdk && npm publish --access public

Subgraph to The Graph

cd subgraph && npx graph deploy pyrimid --studio

---

Security

• Payment verification: Real onchain verification via viem — checks PaymentRouted events + USDC transfers with 5-minute expiry
• Rate limiting: Edge middleware, 60 req/min per IP on catalog/stats, 120/min on MCP
• BigInt safety: calculateSplit() handles both Number and BigInt inputs from web3 libraries
• Contract pattern: ERC-1967 upgradeable proxies with verified source on BaseScan

---

Roadmap

• Core contracts deployed on Base
• SDK v0.2.3 with full catalog pagination
• MCP server with 5 tools
• x402 Bazaar aggregation (92+ products)
• Subgraph indexing on The Graph
• Rate limiting & security hardening
• ERC-8004 identity verification for vendors
• Multi-network support (Arbitrum, Optimism)
• Revenue dashboard for affiliates
• Vendor self-service registration portal

---

Links

---

Built on Base · Payments via x402 · Settlement in USDC