Pyrimid Protocol

Pyrimid Protocol

Base 上の有料 MCP ツールと x402 AI/API 製品のためのエージェントコマースインフラ。

ウェブサイト · クイックスタート · MCP サーバー · npm の SDK · コントラクト

---

Pyrimid とは？

Pyrimid は、ベンダーが有料 MCP ツールや AI API を販売し、エージェントが 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% を受け取ります。ベンダーが支払うのは、実際の売上につながる流通に対してのみです。レイヤーは 1 つだけで、マルチ商法もピラミッドもありません。オンチェーンで、シンプルかつ透明性の高いコミッション分配を実現します。

---

Pyrimid を選ぶ理由

課題	Pyrimid の解決策
エージェントはおすすめを収益化できない	ユーザーに製品をおすすめしてコミッションを獲得できます
ベンダーは多くのエージェントにリーチできない	一度掲載すれば、ネットワーク上のすべてのエージェントに見つけてもらえます
コミッションの支払いが遅く、不透明	スマートコントラクトを通じて USDC で即時決済され、完全に監査可能です
エージェントコマースの標準がない	x402 決済 + MCP ツール + オンチェーンレジストリ = オープンスタンダード

---

クイックスタート

SDK をインストールする

npm install @pyrimid/sdk

エージェント向け — 製品を見つけておすすめする

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

---

購入エージェント向けの稼働中テストエンドポイント

支払いなしでこれらを呼び出すと、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	信頼できるエージェント検索
/api/v1/paid/mya-agent-enrichment?agent=demo	$0.10	エージェント掲載情報の拡充
/api/v1/paid/mya-category-scout?category=developer-tools	$0.05	購入エージェント向けのカテゴリ調査
/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 統合プラン

3 つの統合方法

方法	対象	作業量	効果
埋め込みリゾルバー	エージェントフレームワークとツールキット	3 行	スタック上のすべてのエージェントがコミッションを生み出します
MCP サーバー	エージェントインフラプロバイダー	5 行	エージェントがサーバーに接続して製品を見つけます
ベンダーミドルウェア	API および製品のビルダー	10 行	製品でアフィリエイト流通を有効化します

---

スマートコントラクト（Base Mainnet）

すべてのコントラクトは Base にデプロイされ、検証済みです。ERC-1967 アップグレード可能プロキシパターンを採用しています。

コントラクト	アドレス	目的
Registry	0x34e22fc2...389	アフィリエイトとベンダーの登録、ERC-8004 ID の紐付け
Catalog	0xC935d6B7...908	価格とコミッション率を含む商品リスト
Router	0xc949AEa3...68B	maxPrice スリッページ保護を備えたコミッション分配エンジン
Treasury	0x74A512F4...12C	プロトコル運営資金

---

API リファレンス

Pyrimid API は無料で利用でき、レート制限（60 リクエスト／分）が適用され、JSON を返します。

エンドポイント	メソッド	説明
/api/v1/catalog	GET	検索、フィルター、ページネーションに対応した商品カタログ全体
/api/v1/paid/*	GET	x402 の購入者エージェントテスト用のシード済み有料エンドポイント
/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 の両方の入力に対応
• コントラクトパターン：BaseScan でソース検証済みの ERC-1967 アップグレード可能プロキシ

---

ロードマップ

• Base にコアコントラクトをデプロイ
• カタログ全体のページネーションに対応した SDK v0.2.3
• 5 つのツールを備えた MCP サーバー
• x402 Bazaar の集約（92 以上の商品）
• The Graph でのサブグラフインデックス作成
• レート制限とセキュリティ強化
• ベンダー向け ERC-8004 ID 検証
• マルチネットワーク対応（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 で決済}