Pyrimid Protocol

Pyrimid Protocol

为 Base 上的付费 MCP 工具和 x402 AI/API 产品提供 Agent 商务基础设施。

网站 · 快速入门 · MCP 服务 · npm 上的 SDK · 合约

---

什么是 Pyrimid？

Pyrimid 是一个协议：供应商销售付费 MCP 工具 / AI API，Agent 通过 x402 发现并购买这些产品，佣金通过 Base 上的智能合约以 USDC 即时结算。

Agent discovers a product → purchases via x402 → smart contract splits payment:

  1%        → Protocol treasury
  0–50%     → Affiliate agent (set by vendor)
  Remainder → Vendor

没有联盟推广？供应商可获得 99%。供应商只需为能带来实际销售的分销付费。仅有一层——没有传销，也没有金字塔骗局。只有简洁、透明的链上佣金拆分。

---

为什么选择 Pyrimid？

问题	Pyrimid 的解决方案
Agent 无法将推荐变现	向用户推荐产品即可赚取佣金
供应商无法大规模触达 Agent	上架一次，即可被网络中的每个 Agent 发现
佣金支付缓慢且不透明	通过智能合约以 USDC 即时结算，完全可审计
Agent 商务缺少标准	x402 支付 + MCP 工具 + 链上注册表 = 开放标准

---

快速入门

安装 SDK

npm install @pyrimid/sdk

面向 Agent — 查找并推荐产品

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`);
}

面向供应商 — 上架你的产品

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
    },
  },
}));

面向框架 — 作为默认层嵌入

import { createPyrimidMcpServer } from '@pyrimid/sdk';

// Deploy an MCP server — agents connect, browse, buy
const server = createPyrimidMcpServer({
  affiliateId: 'af_your_id',
  serverName: 'my-recommender',
});

---

实时买家 Agent 测试接口

无需付款即可调用这些接口，并收到包含 x402 accepts[] 元数据的 HTTP 402 响应。付款后，使用 X-PAYMENT 或 X-PAYMENT-TX 重试。

端点	价格	用途
/api/v1/paid/signals	$0.25	BTC 衍生品信号快照
/api/v1/paid/agentzone-search?q=agent-commerce	$0.05	可信 Agent 搜索
/api/v1/paid/mya-agent-enrichment?agent=demo	$0.10	Agent 列表信息补充
/api/v1/paid/mya-category-scout?category=developer-tools	$0.05	为买家 Agent 发掘品类
/api/v1/paid/vendor-lead-discovery?segment=mcp	$0.25	发掘供应商潜在客户
/api/v1/paid/mcp-server-audit?url=https://example.com/mcp	$0.10	MCP 变现审计
/api/v1/paid/x402-integration-plan?service=agent-api	$0.10	供应商 x402 集成方案

三种集成方式

方式	适用对象	工作量	优势
嵌入式解析器	Agent 框架和工具包	3 行	你技术栈中的每个 Agent 都能为你赚取佣金
MCP 服务	Agent 基础设施提供商	5 行	Agent 可连接到你的服务以发现产品
供应商中间件	API 和产品构建者	10 行	在你的产品上启用联盟分销

---

智能合约（Base 主网）

所有合约均已部署并在 Base 上验证。采用 ERC-1967 可升级代理模式。

合约	地址	用途
Registry	0x34e22fc2...389	联盟成员与供应商注册、ERC-8004 身份关联
Catalog	0xC935d6B7...908	提供定价和佣金率的产品列表
Router	0xc949AEa3...68B	佣金分配引擎，提供 maxPrice 滑点保护
Treasury	0x74A512F4...12C	协议运营资金

---

API 参考

Pyrimid API 可免费读取，设有速率限制（60 次请求/分钟），并返回 JSON。

端点	方法	描述
/api/v1/catalog	GET	完整产品目录，支持搜索、筛选和分页
/api/v1/paid/*	GET	用于 x402 买家 Agent 测试的种子付费端点
/api/v1/stats	GET	协议级统计数据（交易量、交易、联盟成员）
/api/v1/stats?type=affiliate&id=af_xxx	GET	联盟成员业绩与收入
/api/v1/stats?type=vendor&id=vn_xxx	GET	供应商分析数据
/api/mcp	POST	MCP JSON-RPC 2.0 端点（Streamable HTTP）
/api/mcp	GET	服务信息与工具定义

MCP 工具

工具	描述
pyrimid_browse	按查询词、价格、类别和验证状态搜索目录
pyrimid_buy	通过 x402 购买产品，并关联联盟成员归因
pyrimid_preview	购买前预览佣金分配
pyrimid_categories	列出所有产品类别及其数量
pyrimid_register_affiliate	在链上注册为联盟成员的说明

---

架构

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

---

开发

# 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

部署

# 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

---

安全

• 支付验证：通过 viem 进行真实的链上验证——检查 PaymentRouted 事件和 USDC 转账，过期时间为 5 分钟
• 速率限制：边缘中间件，目录/统计接口每个 IP 限制为 60 次请求/分钟，MCP 限制为 120 次/分钟
• BigInt 安全性：calculateSplit() 可处理 web3 库传入的 Number 和 BigInt 类型输入
• 合约模式：采用 ERC-1967 可升级代理，并在 BaseScan 上验证源代码

---

路线图

• 在 Base 上部署核心合约
• SDK v0.2.3，支持完整的目录分页
• MCP 服务，包含 5 个工具
• x402 Bazaar 聚合（92+ 个产品）
• 在 The Graph 上建立子图索引
• 速率限制与安全加固
• 为供应商进行 ERC-8004 身份验证
• 支持多网络（Arbitrum、Optimism）
• 面向联盟成员的收入仪表板
• 供应商自助注册门户

---

链接

资源	URL
网站	pyrimid.ai
文档	pyrimid.ai/docs
SDK	npmjs.com/package/@pyrimid/sdk
子图	thegraph.com/studio/subgraph/pyrimid
Registry	BaseScan
Router	BaseScan

---

_{基于 Base 构建 · 通过 x402 支付 · 使用 USDC 结算}