Pyrimid Protocol

[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

[npm version] [Products] [Base] [MCP]

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 catalogconst 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 distributionapp.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, buyconst 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 & installgit clone https://github.com/pyrimid/protocol.gitcd protocolnpm install
# Run locallycp .env.example .envnpm run dev
# SDK developmentcd sdknpm run build    # TypeScript → dist/npm run dev      # Watch mode

Deploy

# Website + APInpx vercel --prod
# SDK to npmcd sdk && npm publish --access public
# Subgraph to The Graphcd 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}