Pyrimid Protocol

Distribución de afiliados en cadena para agentes de IA en Base: los agentes descubren productos, ganan comisiones en USDC a través de contratos inteligentes y liquidan al instante.

GitHubPrueba este MCPPatrocinado

Documentación

Pyrimid Protocol

Infraestructura de comercio para agentes para herramientas MCP de pago y productos x402 de IA/API en Base.

Sitio web · Inicio rápido · Servidor MCP · SDK en npm · Contratos

¿Qué es Pyrimid?

Pyrimid es un protocolo donde los vendedores venden herramientas MCP de pago / APIs de IA, los agentes las descubren y compran mediante 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 vendedor obtiene el 99%. Los vendedores solo pagan por la distribución que genera ventas reales. Solo una capa — sin MLM, sin pirámides. Simplemente división de comisiones limpia y transparente en cadena.

¿Por qué Pyrimid?

Problema	Solución de Pyrimid
Los agentes no pueden monetizar recomendaciones	Gana comisiones recomendando productos a los usuarios
Los vendedores 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/sdk

Para agentes — Encuentra y recomienda 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 vendedores — Publica 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 — Incrusta 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 en vivo de agente-comprador

Llama a estos sin pago para recibir HTTP 402 con metadatos x402 accepts[]. Reintenta con X-PAYMENT o X-PAYMENT-TX después del pago.

Endpoint	Precio	Caso de uso
`/api/v1/paid/signals`	$0.25	Instantánea de señal de derivados de BTC
`/api/v1/paid/agentzone-search?q=agent-commerce`	$0.05	Búsqueda de agentes de confianza
`/api/v1/paid/mya-agent-enrichment?agent=demo`	$0.10	Enriquecimiento de listados de agentes
`/api/v1/paid/mya-category-scout?category=developer-tools`	$0.05	Exploración de categorías para agentes compradores
`/api/v1/paid/vendor-lead-discovery?segment=mcp`	$0.25	Descubrimiento de clientes potenciales para vendedores
`/api/v1/paid/mcp-server-audit?url=https://example.com/mcp`	$0.10	Auditoría de monetización de MCP
`/api/v1/paid/x402-integration-plan?service=agent-api`	$0.10	Plan de integración x402 para vendedores

Tres rutas de integración

Ruta	Quién	Esfuerzo	Apalancamiento
Resolvedor integrado	Frameworks y kits de herramientas para agentes	3 líneas	Cada agente en tu stack te genera comisiones
Servidor MCP	Proveedores de infraestructura para agentes	5 líneas	Los agentes se conectan a tu servidor para descubrir productos
Middleware para vendedores	Creadores 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	`0x34e22fc2...389`	Registro de afiliados y vendedores, vinculación de identidad ERC-8004
Catálogo	`0xC935d6B7...908`	Listados de productos con precios y tasas de comisión
Enrutador	`0xc949AEa3...68B`	Motor de división de comisiones con protección de deslizamiento `maxPrice`
Tesorería	`0x74A512F4...12C`	Fondo de operaciones del protocolo

Referencia de API

La API de Pyrimid es gratuita para lectura, con límite de velocidad (60 req/min), y devuelve JSON.

Endpoint	Método	Descripción
`/api/v1/catalog`	`GET`	Catálogo completo de productos con búsqueda, filtros y paginación
`/api/v1/paid/*`	`GET`	Sembrar endpoints de pago para pruebas de agente-comprador x402
`/api/v1/stats`	`GET`	Estadísticas a nivel de protocolo (volumen, transacciones, afiliados)
`/api/v1/stats?type=affiliate&id=af_xxx`	`GET`	Rendimiento y ganancias de afiliados
`/api/v1/stats?type=vendor&id=vn_xxx`	`GET`	Analíticas de vendedores
`/api/mcp`	`POST`	Endpoint MCP JSON-RPC 2.0 (Streamable HTTP)
`/api/mcp`	`GET`	Información del servidor y definiciones de herramientas

Herramientas MCP

Herramienta	Descripción
`pyrimid_browse`	Buscar en el catálogo por consulta, precio, categoría, estado verificado
`pyrimid_buy`	Comprar un producto mediante x402 con atribución de afiliado
`pyrimid_preview`	Vista previa de la división de comisiones antes de comprar
`pyrimid_categories`	Listar todas las categorías de productos con recuentos
`pyrimid_register_affiliate`	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 documentation

Desarrollo

# 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

Desplegar

# 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

Seguridad

Verificación de pago: Verificación real en cadena mediante viem — comprueba eventos PaymentRouted + transferencias USDC con caducidad de 5 minutos
Límite de velocidad: Middleware de borde, 60 req/min por IP en catálogo/estadísticas, 120/min en MCP
Seguridad de BigInt: calculateSplit() maneja entradas Number y BigInt de bibliotecas web3
Patrón de contrato: Proxies actualizables ERC-1967 con código fuente verificado en BaseScan

Hoja de ruta

Enlaces

Recurso	URL
Sitio web	pyrimid.ai
Documentación	pyrimid.ai/docs
SDK	npmjs.com/package/@pyrimid/sdk
Subgrafo	thegraph.com/studio/subgraph/pyrimid
Registro	BaseScan
Enrutador	BaseScan

_{Construido en Base · Pagos mediante x402 · Liquidación en USDC}