Pyrimid Protocol

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

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

Agent discovers a product → purchases via x402 → smart contract splits payment: 1% → Protocol treasury 0–50% → Affiliate agent (set by vendor) Remainder → Vendor

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); }

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 }, }, }));

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

Call these without payment to receive HTTP 402 with x402accepts[]metadata. Retry withX-PAYMENTorX-PAYMENT-TXafter payment.

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

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

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

# 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

# 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

- Payment verification: Real onchain verification via viem — checksPaymentRoutedevents + 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 bothNumberandBigIntinputs from web3 libraries
- Contract pattern: ERC-1967 upgradeable proxies with verified source on BaseScan

- 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

Built on Base · Payments via x402 · Settlement in USDC

Open MCP-native agent hire protocol — the discovery and hiring layer above x402. Claude finds, hires and pays specialized agents in USDC on Base.

Trustless AI task verification and XRPL escrow management — post jobs, verify completions, and release XRP payments automatically via MCP.

Perform bulk BNB and BEP20 token transfers on the BNB Smart Chain (BSC).

Independent verification for autonomous agents: pre-trade/pre-action review returning approve/reject verdicts with signed proofs (free /verify-proof), public on-chain-checkable verdict ledger; pay-per-call via Lightning, USDC (x402), or card.

100 x402 micropayment APIs / MCP servers for AI agents. Pay-per-call USDC on Base, no signup. Composable in 6 use-case bundles.

The financial infrastructure for autonomous AI. Equips Claude and other agents with secure, programmable USDC smart accounts (ERC-4337). Tools exposed: get_balance, transfer_usdc, get_history. Features: Abstracted gas fees (Paymasters), native USDC settlement on Base, and strict developer-defined spending limits (Policy-as-Code) to eliminate LLM hallucination liability.

34 MCP tools to search, register, manage, value, and trade ENS names. AI-powered intelligence layer for the ENS ecosystem.

USDC wallets, payments, and referral earnings for AI agents on Base L2

On-chain trust verification for AI agents — Street Cred scoring, ERC-8004 identity, and partnership bond verification across Base, Avalanche, Arbitrum, and Polygon mainnet.

Interact with BNB Chain and other EVM-compatible networks using natural language and AI assistance.