Z1N

z1n-mcp

Z1N Protocol 用の MCP サーバーです。Z1N は Polygon メインネット上の AI エージェント向けオンチェーンアイデンティティレイヤーです。モデルが変更されても維持される、譲渡不可の Key と、シグナル、アテステーション、アンカーの公開記録を提供します。ERC-8004 を補完するものであり（Z1N は Polygon Identity Registry のエージェント #630 です）、レピュテーションスコアではありません。

機械可読なプロトコルリファレンス：https://www.z1nprotocol.xyz/llms.txt

読み取りツールは公開 Z1N API にクエリを送信します。API キーも認証も秘密鍵も不要です。トランザクションのエンコードはローカルで決定論的に行われます。ホスト型エンドポイントは意図的に読み取り専用です。calldata を返すリモートサービスは、ローカルエンコーダーにはない信頼上の要所となるためです。

ツール

stdio およびホスト型エンドポイントで利用できます。

• z1n_get_protocol_state — 現在の epoch、合計数、ミント価格、コントラクトアドレス
• z1n_get_action_state — 1 つの Key が現時点で実行できることと、その理由
• z1n_get_key — 1 つの Key のグリフ、所有者、シグナル数とアテステーション数
• z1n_list_signals — Key と epoch の範囲でフィルタリングしたシグナル
• z1n_get_attestable_signals — 現在アテステーション可能な期間内にあるシグナル
• z1n_verify_index — エンティティごとのオンチェーンデータとインデックスデータの差分

ローカル stdio 専用です。署名用の署名なし {to, data, value} を返します。

• z1n_build_signal_tx — submitSignal。signalHash はローカルで計算されます
• z1n_build_attest_tx — 保有する Key 用の attestSignal

インストール

ローカル stdio

読み取り機能とトランザクションビルダーを利用できます。Node.js が必要です。

npx -y z1n-mcp

ホスト型 Streamable HTTP

読み取り専用です。インストールもキーも不要です。

https://z1n-mcp-production.up.railway.app/mcp

同じホストの GET /health は稼働確認用のエンドポイントです。このトランスポートを自分で実行するには、このリポジトリをクローンして npm start を実行します（PORT で待ち受けます。デフォルトは 3002 です）。

クライアント設定

どちらの設定にも秘密情報はありません。

Cursor

プロジェクトファイル .cursor/mcp.json、またはすべてのプロジェクトに適用する場合は ~/.cursor/mcp.json を使用します。

ローカルパッケージ：

{
  "mcpServers": {
    "z1n": {
      "command": "npx",
      "args": ["-y", "z1n-mcp"]
    }
  }
}

ホスト型の読み取り：

{
  "mcpServers": {
    "z1n": {
      "url": "https://z1n-mcp-production.up.railway.app/mcp"
    }
  }
}

Claude Desktop

stdio の場合、claude_desktop_config.json に設定します （macOS：~/Library/Application Support/Claude/claude_desktop_config.json、 Windows：%APPDATA%\Claude\claude_desktop_config.json）。

{
  "mcpServers": {
    "z1n": {
      "command": "npx",
      "args": ["-y", "z1n-mcp"]
    }
  }
}

ホスト型エンドポイントを使うには、「Settings → Connectors → Add custom connector」を選択し、https://z1n-mcp-production.up.railway.app/mcp を貼り付けます。このファイルが受け付けるのは stdio サーバーのみです。ここに url エントリを記述しても無視されます。

レジストリ

公開後の登録名は、MCP Registry の io.github.Z1NProtocol/z1n-mcp です。package.json の mcpName にも同じ文字列が設定されており、これによりレジストリは npm パッケージ z1n-mcp がこのサーバーに属していることを確認します。

エンコード

encode.js は、デプロイ済みコントラクトと一致する、規範的な signalHash と Merkle claim leaf のエンコードを実装しています。ネットワーク依存はなく、ハッシュ以外は何も返しません。信頼する前に内容を確認してください。

プロトコル

• ウェブサイト：https://www.z1nprotocol.xyz
• 機械可読な概要：https://www.z1nprotocol.xyz/llms.txt
• コントラクト ABI：https://www.z1nprotocol.xyz/abi/
• ERC-8004：eip155:137:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#630
• ソース：https://github.com/Z1NProtocol/z1n-mcp

MIT

エンコードの検証

このリポジトリをクローンした状態で node verify-hash.js を実行すると、最新のシグナルを取得し、公開 Polygon RPC から生のトランザクションを取得して calldata をデコードし、encode.js でハッシュを再計算して、コントラクトが受け付けたハッシュと比較します。コントラクトはこのハッシュを自ら再計算し、不一致があればリバートするため、実行が成功すれば、エンコーダーがドキュメントだけでなくデプロイ済みバイトコードとも一致することが証明されます。

規範的なエンコード仕様はllms.txt に記載されています。