provenonce

@provenonce/mcp

Provenonce Skill — あらゆる AI エージェントに、60 秒以内で暗号学的アイデンティティを付与します。

このスキルをエージェントに追加すると、次の機能を利用できます。

• 永続的な暗号学的ハッシュ（アイデンティティ）
• SIGIL（検証済みアイデンティティクラス＋ティア）
• 署名済みパスポート（第三者が誰でもオフラインで検証可能）
• ハートビート（継続的な稼働証明）
• Beats 証明（計算作業の証拠）
• 系譜（完全な祖先チェーン）

クイックスタート

Claude Desktop / Claude Code

~/.claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "provenonce": {
      "command": "npx",
      "args": ["-y", "@provenonce/mcp"]
    }
  }
}

これで完了です。初回使用時に、エージェントは provenonce_register を呼び出し、永続的なアイデンティティを取得します。

既存の認証情報を使用する場合

{
  "mcpServers": {
    "provenonce": {
      "command": "npx",
      "args": ["-y", "@provenonce/mcp"],
      "env": {
        "PROVENONCE_API_KEY": "pvn_...",
        "PROVENONCE_AGENT_HASH": "0x..."
      }
    }
  }
}

スキル開発者として（収益分配を受け取る）

このスキルをフレームワークに組み込む開発者は、パートナー参照トークンを含めてください。

{
  "env": {
    "PROVENONCE_SKILL_REF": "your16hextoken"
  }
}

デプロイしたエージェントが購入する SIGIL ごとに、30% の収益を受け取れます。POST /api/v1/skill/register で登録してください。

11 個のツール

ツール	機能	認証が必要
provenonce_register	エージェントを自動登録し、ハッシュと API キーを取得	不要
provenonce_status	現在の全状態（SIGIL、残高、ヒント）を取得	必要
provenonce_purchase_sigil	SIGIL を購入し、ハートビートとパスポートを利用可能にする	必要＋SOL トランザクション
provenonce_heartbeat	稼働証明を送信	必要＋SOL トランザクション
provenonce_batch_heartbeat	1 回の呼び出しで複数の子エージェントにハートビートを送信	必要＋SOL トランザクション
provenonce_get_passport	署名済みアイデンティティ文書を取得	必要
provenonce_beats_proof	作業証明を計算し、受領証を取得（生成／再同期用）	不要
provenonce_submit_beats	VDF beats を計算し、累計 beats 数に加算	必要
provenonce_verify_agent	別のエージェントのアイデンティティを確認	不要
provenonce_spawn	子エージェントを生成	必要
provenonce_get_lineage	完全な祖先チェーンを取得	不要

使用例

例 1：登録してステータスを確認する

ユーザープロンプト：「Provenonce に登録して、自分のアイデンティティを表示してください。」

想定される動作：

• エージェントは任意の名前を指定して provenonce_register を呼び出します
• 永続的な暗号学的ハッシュ（例：0xabcd...）と API キーを受け取ります
• 認証情報は ~/.provenonce/config.json に保存されます
• エージェントは provenonce_status を呼び出し、アイデンティティ、残高、次の手順を表示します
• ステータス応答には、SIGIL の購入を勧める _hint が含まれます

例 2：信頼する前に別のエージェントを検証する

ユーザープロンプト：「エージェント 0xf7dad8f4...b6fd が正規のものか確認してください。」

想定される動作：

• エージェントは対象のハッシュを指定して provenonce_verify_agent を呼び出します
• 対象エージェントの SIGIL、アイデンティティクラス、ティア、登録日、稼働スコアを返します
• 対象が有効な SIGIL を持ち、最近ハートビートを送信しているかどうかを報告します
• 公開検証エンドポイントのため、認証は不要です

例 3：完全なライフサイクル — SIGIL、ハートビート、パスポート

ユーザープロンプト：「SIGIL を取得し、ハートビートを送信して、パスポートをエクスポートしてください。」

想定される動作：

• エージェントは payment_tx を指定せずに provenonce_purchase_sigil を呼び出し、手数料の案内（SOL 額と ops ウォレットアドレス）を取得します
• ユーザーは SOL で支払い、トランザクション署名を提示します
• エージェントは payment_tx を指定して provenonce_purchase_sigil を再度呼び出し、購入を完了します
• エージェントは provenonce_heartbeat を呼び出し（同じ支払いフロー）、稼働を証明します
• エージェントは provenonce_get_passport を呼び出し、暗号学的に署名されたアイデンティティ文書を受け取ります
• パスポートは、Provenonce の認証機関の公開鍵を使って、第三者が誰でもオフラインで検証できます

エージェントのフロー

Day 1:  provenonce_register      → hash minted, credentials saved
        provenonce_beats_proof   → works immediately, no SIGIL needed
        provenonce_status        → { sigil: null, _hint: "Call provenonce_purchase_sigil..." }

Day 7:  provenonce_purchase_sigil → pay SOL, SIGIL issued
        provenonce_heartbeat     → now unlocked
        provenonce_get_passport  → signed identity doc, share with anyone
        provenonce_verify_agent  → verify a counterparty before trusting them

環境変数

変数	説明	デフォルト
PROVENONCE_API_KEY	エージェント API キー（pvn_...）	~/.provenonce/config.json から読み込み
PROVENONCE_AGENT_HASH	エージェントハッシュ（0x...）	~/.provenonce/config.json から読み込み
PROVENONCE_SKILL_REF	パートナー参照トークン（収益分配用）	なし
PROVENONCE_REGISTRY_URL	レジストリ URL の上書き	https://provenonce.io

フレームワークに依存しない使用方法

import { PROVENONCE_TOOLS } from '@provenonce/mcp/tools';

// OpenAI
const tools = PROVENONCE_TOOLS.map(t => ({ type: 'function', function: t }));

// LangChain / custom — use PROVENONCE_TOOLS for schema, implement handlers yourself

認証情報の保存

認証情報は、Unix では chmod 600 の権限で ~/.provenonce/config.json に保存されます。

Windows では、環境変数（PROVENONCE_API_KEY + PROVENONCE_AGENT_HASH）を使用してください。ファイルのアクセス権限は適用されません。

プライバシーポリシー

Provenonce は、暗号学的なアイデンティティサービスの提供に必要な最小限のデータを収集します。

• 収集するデータ： エージェント名（任意）、暗号学的ハッシュ（生成）、API キー、SIGIL メタデータ、ハートビートのタイムスタンプ、支払いに関する Solana トランザクション署名。
• データの使用方法： エージェントのアイデンティティレジストリの維持、エージェントの稼働状況の確認、署名済みパスポートの発行に使用します。第三者にデータを販売することはありません。
• 保存： エージェントの状態は Supabase（PostgreSQL）に保存されます。改ざん防止タイムスタンプは、Solana ブロックチェーン上に SPL Memo トランザクションとして記録されます。
• 第三者との共有： オンチェーンメモ（登録、SIGIL）は Solana 上で公開されています。それ以外のデータを第三者と共有することはありません。
• 保持期間： エージェントの記録は、来歴チェーンの一部として無期限に保持されます。失効したエージェントはマークされますが、削除されません。
• 連絡先： [email protected]

プライバシーポリシー全文：provenonce.dev/legal/privacy

サポート

• ドキュメント：provenonce.dev
• 問題の報告：github.com/ProvenonceAI/provenonce-mcp/issues
• メール：[email protected]

今後の予定

• provenonce_kyc — KYC／アイデンティティクラスのアップグレード
• 自動ハートビートタイマー（オプトイン）
• Python SDK（provenonce-py）

ライセンス

MIT — LICENSE を参照してください

リンク

• レジストリ：provenonce.io
• ドキュメント：provenonce.dev
• API：provenonce.io/openapi.yaml