Epinu

Epinu MCP — 現実世界のアセットマーケットプレイスへのエージェント用窓口

Epinu は、現実世界のアセットを扱うエージェントファーストのマーケットプレイスです。まず農業とエネルギー分野から始まり、鉱業、設備、産業サービスへと拡大しています。AI エージェントは第一級のユーザーとして、MCP を通じて直接検索、閲覧、取引の下書きを作成できます。また、すべての書き込みは、完全な監査証跡を備えた人間承認ブローカーを経由します。

これは、Epinu がホストする MCP エンドポイントの公開統合リポジトリです。レジストリのメタデータ（公式 MCP Registry の ai.epinu/epinu）、実行可能なサンプル、運用チェックが含まれます。Epinu プラットフォームの実装は別途管理されています。

• エンドポイント： https://api.epinu.ai/api/agent/mcp（Streamable HTTP、JSON-RPC 2.0）
• エージェント向けの最新ドキュメント： epinu.ai/llms.txt
• マニフェスト： epinu.ai/.well-known/mcp

60 秒で試す — アカウントもトークンも不要

bash examples/quickstart.sh

これは現在稼働中の公開本番エンドポイントに匿名でクエリを送り、最新の公開プロジェクトとマーケットプレイスの検索結果を返します。現在、サンプルクエリではテキサス州オデッサの ASIC 修理センターと関連サービスが表示されます。掲載情報は変わる場合があります。（2026-07-15 時点で、QA 用データは公開読み取りの対象外です。）匿名利用では、公開データに対する initialize、tools/list、5 つの読み取りツール（getting_started、marketplace_listings_search、projects_search、search、fetch）を利用できます。詳細はリファレンスの TOOLS.md をご覧ください。

依存関係ゼロの通常の Node で同じ操作を行う方法（Node ≥ 18）：

node examples/walkthrough.mjs

Claude Code／任意の MCP クライアントから接続する

claude mcp add --transport http epinu https://api.epinu.ai/api/agent/mcp

または .mcp.json に次のように記述します。

{
  "mcpServers": {
    "epinu": {
      "type": "http",
      "url": "https://api.epinu.ai/api/agent/mcp"
    }
  }
}

読み取り専用モードならすぐに動作します。エージェントが取引の下書きを作成できるようにするには、委任トークンを使って "headers": {"Authorization": "Bearer epagt_..."} を追加してください。取得方法は以下をご覧ください。詳しくは examples/claude-code.md をご覧ください。

注目すべき点：書き込みは実行されません

Epinu の書き込みツール（marketplace_listing_create、project_create、…）は、データベースに書き込みません。代わりに、提案（status: pending）を作成して approval_url を返します。人間が Epinu ダッシュボードで提案を確認し、承認または却下します。承認された場合にのみ変更が実行されます。

examples/walkthrough.mjs では、検索 → 保留中の提案の作成 → ステータスの確認という、エージェントが操作するフローの部分を紹介しています。人間による承認は Epinu ダッシュボードで別途行います。examples/walkthrough.md は、実際の本番実行を記録し、情報を伏せたトランスクリプトです。提案が作成され、人間が確認して却下したため、書き込みは一切行われていません。

すべての書き込みで人間の承認が必要なのはなぜですか？

• エージェントは誤りを犯します。市場は現実です。 架空の出品、誤った価格、重複は、提案の段階なら簡単に却下できますが、公開後に取り消すのは大変です。ブローカーを介すことで、障害の形を「不適切な書き込みが本番環境に反映された」ではなく、「人間が却下をクリックした」にできます。
• 本人確認と監査。 すべての提案には、actor.type=personal_agent とエージェントのクライアント ID が記録されます。人間は、どのエージェントが何を提案したかを常に把握でき、その記録は保持されます。
• アカウント乗っ取りではなく、範囲を限定した委任。 epagt_ トークンは、アカウント所有者が明示的なスコープを指定して作成します（ダッシュボード → 設定 → エージェントを認証）。スコープ外の呼び出しは、明確なスコープエラーとなって失敗します。削除やプロフィール変更などの機密性の高い操作では、承認時に人間側で新たに MFA を行う必要があります。
• 変更の確認。 提案から承認までの間に基盤となるデータが大幅に変更された場合、承認はブロックされるか、明示的な確認が必要になります。エージェントが古い変更を承認させることはできません。
• 未承認の提案は、7 日後に自動的に期限切れになります。

本番環境での実績： Epinu によると、同社で最初に外部マーケットプレイスの参加者を受け入れた際、委任された AI エージェントを通じてオンボーディングを行いました。エージェントがカタログの提案を準備し、アカウント所有者がダッシュボードで確認して承認しました。サニタイズ済みの事例紹介を近日公開予定です。

トークンの取得（書き込み用）

1. epinu.ai/signup でアカウントを作成します
2. ダッシュボード → 設定 → エージェントを認証 → スコープを選択 → epagt_ トークンをコピーするか、エージェントの人間担当者に https://epinu.ai/authorize-agent?name=<AgentName>&scopes=<scopes> を送信します
3. POST /api/agent/mcp で Authorization: Bearer epagt_... として使用します （このトークンは MCP エンドポイントでのみ有効です）

このリポジトリの内容

ファイル	内容
server.json	ai.epinu/epinu の MCP Registry エントリー
examples/quickstart.sh	匿名ユーザー向けの利用を 60 秒で開始（curl）
examples/walkthrough.mjs	検索 → 承認待ちの提案を作成 → 提案のステータスを確認（Node、依存関係ゼロ）
examples/walkthrough.md	実際の本番環境での実行を記録し、機密情報を除去したトランスクリプト
examples/claude-code.md	Claude Code / .mcp.json から接続
TOOLS.md	実際の応答例を含む、匿名ユーザー向けツールリファレンス
SECURITY.md	脆弱性の報告方法

正式な最新のエージェント向けドキュメントは、サイト上で公開されています： llms.txt · .well-known/mcp。このリポジトリでは、内容が古くなるのを防ぐため、ドキュメントの複製ではなくリンクを掲載しています。

ライセンス

このリポジトリ内のサンプルとドキュメント：MIT。 Epinu プラットフォーム自体はホスト型サービスです — epinu.ai。