pyrimid
¿Qué es Pyrimid?
Pyrimid es un protocolo donde los proveedores venden herramientas MCP de pago / API de IA, los agentes las descubren y compran a través de x402, y las comisiones se liquidan al instante en USDC mediante contratos inteligentes en Base.
Agent discovers a product → purchases via x402 → smart contract splits payment:
1% → Protocol treasury
0–50% → Affiliate agent (set by vendor)
Remainder → Vendor¿Sin afiliado? El proveedor obtiene el 99%. Los proveedores solo pagan por la distribución que genera ventas reales. Una sola capa: sin MLM, sin pirámides. Solo una división de comisiones limpia y transparente en la cadena.
Related MCP server: Moltjiji
¿Por qué Pyrimid?
Problema | Solución de Pyrimid |
Los agentes no pueden monetizar recomendaciones | Gana comisiones recomendando productos a los usuarios |
Los proveedores no pueden llegar a los agentes a escala | Publica una vez, sé descubierto por cada agente en la red |
Los pagos de comisiones son lentos y opacos | Liquidación instantánea en USDC mediante contratos inteligentes: totalmente auditable |
No hay estándar para el comercio de agentes | Pagos x402 + herramientas MCP + registro en cadena = estándar abierto |
Inicio rápido
Instalar el SDK
npm install @pyrimid/sdkPara agentes: encontrar y recomendar productos
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`);
}Para proveedores: listar tu producto
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
},
},
}));Para frameworks: integrar como capa predeterminada
import { createPyrimidMcpServer } from '@pyrimid/sdk';
// Deploy an MCP server — agents connect, browse, buy
const server = createPyrimidMcpServer({
affiliateId: 'af_your_id',
serverName: 'my-recommender',
});Superficies de prueba de agente-comprador en vivo
Llama a estos sin pago para recibir HTTP 402 con metadatos accepts[] de x402. Vuelve a intentar con X-PAYMENT o X-PAYMENT-TX después del pago.
Endpoint | Precio | Caso de uso |
| $0.25 | Instantánea de señal de derivados de BTC |
| $0.05 | Búsqueda de agentes de confianza |
| $0.10 | Enriquecimiento de listado de agentes |
| $0.05 | Exploración de categorías para agentes compradores |
| $0.25 | Descubrimiento de leads de proveedores |
| $0.10 | Auditoría de monetización MCP |
| $0.10 | Plan de integración x402 del proveedor |
Tres rutas de integración
Ruta | Quién | Esfuerzo | Apalancamiento |
Resolvedor integrado | Frameworks y kits de herramientas de agentes | 3 líneas | Cada agente en tu stack te genera comisiones |
Servidor MCP | Proveedores de infraestructura de agentes | 5 líneas | Los agentes se conectan a tu servidor para descubrir productos |
Middleware de proveedor | Constructores de API y productos | 10 líneas | Activa la distribución de afiliados en tu producto |
Contratos inteligentes (Base Mainnet)
Todos los contratos están desplegados y verificados en Base. Patrón de proxy actualizable ERC-1967.
Contrato | Dirección | Propósito |
Registro | Registro de afiliados y proveedores, vinculación de identidad ERC-8004 | |
Catálogo | Listados de productos con precios y tasas de comisión | |
Router | Motor de división de comisiones con protección contra deslizamiento | |
Tesorería | Fondo de operaciones del protocolo |
Referencia de API
La API de Pyrimid es gratuita para leer, tiene límite de tasa (60 req/min) y devuelve JSON.
Endpoint | Método | Descripción |
|
| Catálogo completo de productos con búsqueda, filtros, paginación |
|
| Endpoints de pago semilla para pruebas de agente-comprador x402 |
|
| Estadísticas a nivel de protocolo (volumen, transacciones, afiliados) |
|
| Rendimiento y ganancias de afiliados |
|
| Analíticas de proveedores |
|
| Endpoint MCP JSON-RPC 2.0 (HTTP transmitible) |
|
| Información del servidor y definiciones de herramientas |
Herramientas MCP
Herramienta | Descripción |
| Buscar en el catálogo por consulta, precio, categoría, estado verificado |
| Comprar un producto a través de x402 con atribución de afiliado |
| Previsualizar la división de comisiones antes de comprar |
| Listar todas las categorías de productos con conteos |
| Instrucciones para registrarse como afiliado en cadena |
Arquitectura
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 documentationDesarrollo
# 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 modeDesplegar
# Website + API
npx vercel --prod
# SDK to npm
cd sdk && npm publish --access public
# Subgraph to The Graph
cd subgraph && npx graph deploy pyrimid --studioSeguridad
Verificación de pago: Verificación real en cadena a través de viem — comprueba eventos
PaymentRouted+ transferencias USDC con caducidad de 5 minutosLímite de tasa: Middleware de borde, 60 req/min por IP en catálogo/estadísticas, 120/min en MCP
Seguridad BigInt:
calculateSplit()maneja entradas tantoNumbercomoBigIntde bibliotecas web3Patrón de contrato: Proxies actualizables ERC-1967 con código fuente verificado en BaseScan
Hoja de ruta
[x] Contratos principales desplegados en Base
[x] SDK v0.2.3 con paginación completa del catálogo
[x] Servidor MCP con 5 herramientas
[x] Agregación de Bazaar x402 (más de 92 productos)
[x] Indexación de subgrafo en The Graph
[x] Límite de tasa y endurecimiento de seguridad
[ ] Verificación de identidad ERC-8004 para proveedores
[ ] Soporte multired (Arbitrum, Optimism)
[ ] Panel de ingresos para afiliados
[ ] Portal de registro de autoservicio para proveedores
Enlaces
Recurso | URL |
Sitio web | |
Documentación | |
SDK | |
Subgrafo | |
Registro | |
Router |
This server cannot be deployed
Maintenance
Related MCP Connectors
Agentic commerce network: discover sellers and products, negotiate, and pay USDC on Base via x402.
Multi-seller shopping for AI agents. Settle via Stripe MPP or x402 USDC on Base. Hosted.
Multi-seller shopping for AI agents. Settle via Stripe MPP or x402 USDC on Base. Hosted.
AI agent-to-agent SLA agreements on Base with insurance, reputation, and x402 payments.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to autonomously request services from other specialized agents and compensate them via x402 micropayments. Demonstrates a Machine-to-Machine economy using A2A protocol for agent communication, MCP for context management, and blockchain-based payments on Base network.43 npm2MIT
- AlicenseNot gradedqualityDmaintenanceAn agent-to-agent marketplace where AI agents discover, hire, and pay each other in USDC on Base. Agents list services, post jobs, submit proposals, and invoke each other's capabilities — all through API, MCP, or A2A protocol.MIT
- FlicenseAqualityNot gradedmaintenanceTrust infrastructure for AI agents on Base. DEX Spread Oracle (live Uniswap V3 prices), on-chain escrow, insurance pool, and collective knowledge base. 7 smart contracts. Pay-per-query via x402 micropayments in USDC.6-
- FlicenseAqualityCmaintenancePay-per-call tools for AI agents including trust checks, due diligence, market data, and human-verified approvals, settled in USDC on Base via the x402 protocol.16-