[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_104":105},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@pyrimid-ai/pyrimid' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":57,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","pyrimid-ai","moduleId","pyrimid","@pyrimid-ai/pyrimid","displayName","Pyrimid Protocol","tagline","Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.","iconKey","https://avatars.githubusercontent.com/u/270338674?v=4","category","ai-agents","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://pyrimid.ai/api/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363197000,"updatedAt",1781499312000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.pyrimid%2Fpyrimid","sourceVerified",false,"importedAt","upstreamStars",0,"upstreamUpdatedAt",1778593168000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/pyrimid-ai/pyrimid","githubRepoFullName","pyrimid-ai/pyrimid","releaseId","ext-pyrimid-ai-pyrimid","version","1.0.0","descriptionMarkdown","

\n $\"Pyrimid$ \n

\n\n

Pyrimid Protocol

\n\n

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

\n\n

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

\n\n

\n $\"npm$ \n $\"Products\"$ \n $\"Base\"$ \n $\"MCP\"$ \n

\n\n---\n\n## What is Pyrimid?\n\nPyrimid 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.\n\n```\nAgent discovers a product → purchases via x402 → smart contract splits payment:\n\n 1% → Protocol treasury\n 0–50% → Affiliate agent (set by vendor)\n Remainder → Vendor\n```\n\nNo 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.\n\n---\n\n## Why Pyrimid?\n\n| Problem | Pyrimid's Solution |\n|---------|-------------------|\n| Agents can't monetize recommendations | Earn commissions by recommending products to users |\n| Vendors can't reach agents at scale | List once, get discovered by every agent on the network |\n| Commission payments are slow & opaque | Instant USDC settlement via smart contracts — fully auditable |\n| No standard for agent commerce | x402 payments + MCP tools + onchain registry = open standard |\n\n---\n\n## Quick Start\n\n### Install the SDK\n\n```bash\nnpm install @pyrimid/sdk\n```\n\n### For Agents — Find & Recommend Products\n\n```typescript\nimport { PyrimidResolver } from '@pyrimid/sdk';\n\nconst resolver = new PyrimidResolver({ affiliateId: 'af_your_id' });\n\n// Search the catalog\nconst product = await resolver.findProduct(\"trading signals\");\n\n// Purchase with x402 payment (auto-splits commissions)\nif (product) {\n const receipt = await resolver.purchase(product, agentWallet);\n console.log(`Earned: $${receipt.affiliate_earned / 1_000_000} USDC`);\n}\n```\n\n### For Vendors — List Your Product\n\n```typescript\nimport { pyrimidMiddleware } from '@pyrimid/sdk';\n\n// 10 lines to activate affiliate distribution\napp.use(pyrimidMiddleware({\n vendorId: 'vn_your_id',\n products: {\n '/api/signals/latest': {\n productId: 'signals_latest',\n price: 250_000, // $0.25 USDC\n affiliateBps: 1000, // 10% to affiliates\n },\n },\n}));\n```\n\n### For Frameworks — Embed as Default Layer\n\n```typescript\nimport { createPyrimidMcpServer } from '@pyrimid/sdk';\n\n// Deploy an MCP server — agents connect, browse, buy\nconst server = createPyrimidMcpServer({\n affiliateId: 'af_your_id',\n serverName: 'my-recommender',\n});\n```\n\n---\n\n## Live buyer-agent test surfaces\n\nCall these without payment to receive HTTP 402 with x402 `accepts[]` metadata. Retry with `X-PAYMENT` or `X-PAYMENT-TX` after payment.\n\n| Endpoint | Price | Use case |\n|----------|-------|----------|\n| `/api/v1/paid/signals` | $0.25 | BTC derivatives signal snapshot |\n| `/api/v1/paid/agentzone-search?q=agent-commerce` | $0.05 | Trusted agent search |\n| `/api/v1/paid/mya-agent-enrichment?agent=demo` | $0.10 | Agent listing enrichment |\n| `/api/v1/paid/mya-category-scout?category=developer-tools` | $0.05 | Category scouting for buyer agents |\n| `/api/v1/paid/vendor-lead-discovery?segment=mcp` | $0.25 | Vendor lead discovery |\n| `/api/v1/paid/mcp-server-audit?url=https://example.com/mcp` | $0.10 | MCP monetization audit |\n| `/api/v1/paid/x402-integration-plan?service=agent-api` | $0.10 | Vendor x402 integration plan |\n\n## Three Integration Paths\n\n| Path | Who | Effort | Leverage |\n|------|-----|--------|----------|\n| **Embedded Resolver** | Agent frameworks & toolkits | 3 lines | Every agent on your stack earns you commissions |\n| **MCP Server** | Agent infrastructure providers | 5 lines | Agents connect to your server to discover products |\n| **Vendor Middleware** | API & product builders | 10 lines | Activate affiliate distribution on your product |\n\n---\n\n## Smart Contracts (Base Mainnet)\n\nAll contracts are deployed and verified on Base. ERC-1967 upgradeable proxy pattern.\n\n| Contract | Address | Purpose |\n|----------|---------|---------|\n| **Registry** | [`0x34e22fc2...389`](https://basescan.org/address/0x34e22fc20D457095e2814CdFfad1e42980EEC389) | Affiliate & vendor registration, ERC-8004 identity linking |\n| **Catalog** | [`0xC935d6B7...908`](https://basescan.org/address/0xC935d6B73034dDDb97AD2a1BbD2106F34A977908) | Product listings with pricing & commission rates |\n| **Router** | [`0xc949AEa3...68B`](https://basescan.org/address/0xc949AEa380D7b7984806143ddbfE519B03ABd68B) | Commission splitting engine with `maxPrice` slippage protection |\n| **Treasury** | [`0x74A512F4...12C`](https://basescan.org/address/0x74A512F4f3F64aD479dEc4554a12855Ce943E12C) | Protocol operations fund |\n\n---\n\n## API Reference\n\nThe Pyrimid API is free to read, rate-limited (60 req/min), and returns JSON.\n\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `/api/v1/catalog` | `GET` | Full product catalog with search, filters, pagination |\n| `/api/v1/paid/*` | `GET` | Seed paid endpoints for x402 buyer-agent testing |\n| `/api/v1/stats` | `GET` | Protocol-level stats (volume, transactions, affiliates) |\n| `/api/v1/stats?type=affiliate&id=af_xxx` | `GET` | Affiliate performance & earnings |\n| `/api/v1/stats?type=vendor&id=vn_xxx` | `GET` | Vendor analytics |\n| `/api/mcp` | `POST` | MCP JSON-RPC 2.0 endpoint (Streamable HTTP) |\n| `/api/mcp` | `GET` | Server info & tool definitions |\n\n### MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `pyrimid_browse` | Search catalog by query, price, category, verified status |\n| `pyrimid_buy` | Purchase a product via x402 with affiliate attribution |\n| `pyrimid_preview` | Preview the commission split before buying |\n| `pyrimid_categories` | List all product categories with counts |\n| `pyrimid_register_affiliate` | Instructions to register as an affiliate onchain |\n\n---\n\n## Architecture\n\n```\npyrimid/\n├── app/ # Next.js 15 (Vercel, region: bom1)\n│ ├── page.tsx # Landing page\n│ ├── dashboard/ # Protocol dashboard\n│ └── api/\n│ ├── v1/catalog/ # Aggregated product catalog\n│ ├── v1/paid/ # Seed x402 paid endpoints\n│ ├── v1/stats/ # Protocol & affiliate analytics\n│ └── mcp/ # MCP JSON-RPC endpoint\n├── sdk/ # @pyrimid/sdk (published to npm)\n│ └── src/\n│ ├── resolver.ts # PyrimidResolver — search, purchase, stats\n│ ├── mcp-server.ts # MCP server factory\n│ ├── middleware.ts # Vendor payment middleware + calculateSplit()\n│ └── types.ts # ABIs, addresses, interfaces\n├── subgraph/ # The Graph indexer (Base)\n│ ├── schema.graphql # PaymentRouted, Affiliate, Vendor entities\n│ ├── subgraph.yaml # 4 data sources\n│ └── src/mapping.ts # Event handlers\n├── middleware.ts # Edge rate limiting (60/min API, 120/min MCP)\n└── public/docs/ # Developer documentation\n```\n\n---\n\n## Development\n\n```bash\n# Clone & install\ngit clone https://github.com/pyrimid/protocol.git\ncd protocol\nnpm install\n\n# Run locally\ncp .env.example .env\nnpm run dev\n\n# SDK development\ncd sdk\nnpm run build # TypeScript → dist/\nnpm run dev # Watch mode\n```\n\n### Deploy\n\n```bash\n# Website + API\nnpx vercel --prod\n\n# SDK to npm\ncd sdk && npm publish --access public\n\n# Subgraph to The Graph\ncd subgraph && npx graph deploy pyrimid --studio\n```\n\n---\n\n## Security\n\n- **Payment verification**: Real onchain verification via viem — checks `PaymentRouted` events + USDC transfers with 5-minute expiry\n- **Rate limiting**: Edge middleware, 60 req/min per IP on catalog/stats, 120/min on MCP\n- **BigInt safety**: `calculateSplit()` handles both `Number` and `BigInt` inputs from web3 libraries\n- **Contract pattern**: ERC-1967 upgradeable proxies with verified source on BaseScan\n\n---\n\n## Roadmap\n\n- [x] Core contracts deployed on Base\n- [x] SDK v0.2.3 with full catalog pagination\n- [x] MCP server with 5 tools\n- [x] x402 Bazaar aggregation (92+ products)\n- [x] Subgraph indexing on The Graph\n- [x] Rate limiting & security hardening\n- [ ] ERC-8004 identity verification for vendors\n- [ ] Multi-network support (Arbitrum, Optimism)\n- [ ] Revenue dashboard for affiliates\n- [ ] Vendor self-service registration portal\n\n---\n\n## Links\n\n| Resource | URL |\n|----------|-----|\n| Website | [pyrimid.ai](https://pyrimid.ai) |\n| Documentation | [pyrimid.ai/docs](https://pyrimid.ai/docs) |\n| SDK | [npmjs.com/package/@pyrimid/sdk](https://www.npmjs.com/package/@pyrimid/sdk) |\n| Subgraph | [thegraph.com/studio/subgraph/pyrimid](https://thegraph.com/studio/subgraph/pyrimid) |\n| Registry | [BaseScan](https://basescan.org/address/0x34e22fc20D457095e2814CdFfad1e42980EEC389) |\n| Router | [BaseScan](https://basescan.org/address/0xc949AEa380D7b7984806143ddbfE519B03ABd68B) |\n\n---\n\n

\n _{Built on Base · Payments via x402 · Settlement in USDC}\n

\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","categoryDisplayName","AI Agents","upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":103},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":57,"_93":57},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","ai.pyrimid/pyrimid","homepage","https://pyrimid.ai","ENV",{"_106":107,"_108":109,"_110":111},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]