pyrimid
What is Pyrimid?
Pyrimid is a protocol where vendors list digital products, AI agents distribute them as affiliates, 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 → VendorNo 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?
Problem | Pyrimid's Solution |
Agents can't monetize recommendations | Earn commissions by recommending products to users |
Vendors can't reach agents at scale | List once, get discovered by every agent on the network |
Commission payments are slow & opaque | Instant USDC settlement via smart contracts — fully auditable |
No standard for agent commerce | x402 payments + MCP tools + onchain registry = open standard |
Quick Start
Install the SDK
npm install @pyrimid/sdkFor 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',
});Three Integration Paths
Path | Who | Effort | Leverage |
Embedded Resolver | Agent frameworks & toolkits | 3 lines | Every agent on your stack earns you commissions |
MCP Server | Agent infrastructure providers | 5 lines | Agents connect to your server to discover products |
Vendor Middleware | API & product builders | 10 lines | Activate affiliate distribution on your product |
Smart Contracts (Base Mainnet)
All contracts are deployed and verified on Base. ERC-1967 upgradeable proxy pattern.
Contract | Address | Purpose |
Registry | Affiliate & vendor registration, ERC-8004 identity linking | |
Catalog | Product listings with pricing & commission rates | |
Router | Commission splitting engine with | |
Treasury | Protocol operations fund |
API Reference
The Pyrimid API is free to read, rate-limited (60 req/min), and returns JSON.
Endpoint | Method | Description |
|
| Full product catalog with search, filters, pagination |
|
| Protocol-level stats (volume, transactions, affiliates) |
|
| Affiliate performance & earnings |
|
| Vendor analytics |
|
| MCP JSON-RPC 2.0 endpoint (Streamable HTTP) |
|
| Server info & tool definitions |
MCP Tools
Tool | Description |
| Search catalog by query, price, category, verified status |
| Purchase a product via x402 with affiliate attribution |
| Preview the commission split before buying |
| List all product categories with counts |
| Instructions to register as an affiliate onchain |
Architecture
pyrimid/
├── app/ # Next.js 15 (Vercel, region: bom1)
│ ├── page.tsx # Landing page
│ ├── dashboard/ # Protocol dashboard
│ └── api/
│ ├── v1/catalog/ # Aggregated product catalog (92+ products)
│ ├── 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 documentationDevelopment
# 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 modeDeploy
# Website + API
npx vercel --prod
# SDK to npm
cd sdk && npm publish --access public
# Subgraph to The Graph
cd subgraph && npx graph deploy pyrimid --studioSecurity
Payment verification: Real onchain verification via viem — checks
PaymentRoutedevents + USDC transfers with 5-minute expiryRate limiting: Edge middleware, 60 req/min per IP on catalog/stats, 120/min on MCP
BigInt safety:
calculateSplit()handles bothNumberandBigIntinputs from web3 librariesContract 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
Resource | URL |
Website | |
Documentation | |
SDK | |
Subgraph | |
Registry | |
Router |
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/pyrimid-ai/pyrimid'
If you have feedback or need assistance with the MCP directory API, please join our Discord server