Skip to main content
Glama

¿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/sdk

Para 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

/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 listado 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 leads de proveedores

/api/v1/paid/mcp-server-audit?url=https://example.com/mcp

$0.10

Auditoría de monetización MCP

/api/v1/paid/x402-integration-plan?service=agent-api

$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

0x34e22fc2...389

Registro de afiliados y proveedores, vinculación de identidad ERC-8004

Catálogo

0xC935d6B7...908

Listados de productos con precios y tasas de comisión

Router

0xc949AEa3...68B

Motor de división de comisiones con protección contra deslizamiento maxPrice

Tesorería

0x74A512F4...12C

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

/api/v1/catalog

GET

Catálogo completo de productos con búsqueda, filtros, paginación

/api/v1/paid/*

GET

Endpoints de pago semilla 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 proveedores

/api/mcp

POST

Endpoint MCP JSON-RPC 2.0 (HTTP transmitible)

/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 a través de x402 con atribución de afiliado

pyrimid_preview

Previsualizar la división de comisiones antes de comprar

pyrimid_categories

Listar todas las categorías de productos con conteos

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 a través de viem — comprueba eventos PaymentRouted + transferencias USDC con caducidad de 5 minutos

  • Lí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 tanto Number como BigInt de bibliotecas web3

  • Patró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


Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    Enables 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 npm
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An 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
  • F
    license
    A
    quality
    Not graded
    maintenance
    Trust 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
    -