Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β we're steadily working through the catalog.
π‘ Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Pyrimid Protocol.
pyrimid_browseSearch catalog by query, price, category, verified status
pyrimid_buyPurchase a product via x402 with affiliate attribution
pyrimid_previewPreview the commission split before buying
pyrimid_categoriesList all product categories with counts
pyrimid_register_affiliateInstructions to register as an affiliate onchain
Agent-commerce infra for paid MCP tools and x402 AI/API products on Base.
Website Β· Quickstart Β· MCP Server Β· SDK on npm Β· Contracts
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.
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.
| 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 |
Call these without payment to receive HTTP 402 with x402 accepts[] metadata. Retry with X-PAYMENT or X-PAYMENT-TX after payment.
| Endpoint | Price | Use case |
|---|---|---|
/api/v1/paid/signals | $0.25 | BTC derivatives signal snapshot |
/api/v1/paid/agentzone-search?q=agent-commerce | $0.05 | Trusted agent search |
/api/v1/paid/mya-agent-enrichment?agent=demo | $0.10 | Agent listing enrichment |
/api/v1/paid/mya-category-scout?category=developer-tools | $0.05 | Category scouting for buyer agents |
/api/v1/paid/vendor-lead-discovery?segment=mcp | $0.25 | Vendor lead discovery |
/api/v1/paid/mcp-server-audit?url=https://example.com/mcp | $0.10 | MCP monetization audit |
/api/v1/paid/x402-integration-plan?service=agent-api | $0.10 | Vendor x402 integration plan |
| 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 |
All contracts are deployed and verified on Base. ERC-1967 upgradeable proxy pattern.
| Contract | Address | Purpose |
|---|---|---|
| Registry | 0x34e22fc2...389 | Affiliate & vendor registration, ERC-8004 identity linking |
| Catalog | 0xC935d6B7...908 | Product listings with pricing & commission rates |
| Router | 0xc949AEa3...68B | Commission splitting engine with maxPrice slippage protection |
| Treasury | 0x74A512F4...12C | Protocol operations fund |
The Pyrimid API is free to read, rate-limited (60 req/min), and returns JSON.
| Endpoint | Method | Description |
|---|---|---|
/api/v1/catalog | GET | Full product catalog with search, filters, pagination |
/api/v1/paid/* | GET | Seed paid endpoints for x402 buyer-agent testing |
/api/v1/stats | GET | Protocol-level stats (volume, transactions, affiliates) |
/api/v1/stats?type=affiliate&id=af_xxx | GET | Affiliate performance & earnings |
/api/v1/stats?type=vendor&id=vn_xxx | GET | Vendor analytics |
/api/mcp | POST | MCP JSON-RPC 2.0 endpoint (Streamable HTTP) |
/api/mcp | GET | Server info & tool definitions |
| Tool | Description |
|---|---|
pyrimid_browse | Search catalog by query, price, category, verified status |
pyrimid_buy | Purchase a product via x402 with affiliate attribution |
pyrimid_preview | Preview the commission split before buying |
pyrimid_categories | List all product categories with counts |
pyrimid_register_affiliate | Instructions to register as an affiliate onchain |
PaymentRouted events + USDC transfers with 5-minute expirycalculateSplit() handles both Number and BigInt inputs from web3 libraries| Resource | URL |
|---|---|
| Website | pyrimid.ai |
| Documentation | pyrimid.ai/docs |
| SDK | npmjs.com/package/@pyrimid/sdk |
| Subgraph | thegraph.com/studio/subgraph/pyrimid |
| Registry | BaseScan |
| Router | BaseScan |
Built on Base Β· Payments via x402 Β· Settlement in USDC
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/pyrimid-protocol)<a href="https://allmcps.com/mcp/pyrimid-protocol"><img src="https://allmcps.com/api/badge/pyrimid-protocol?style=directory" alt="Pyrimid Protocol on AllMCPs" /></a>