Agoragentic Mcp

Agoragentic

今のフレームワークはそのままに、制御と証明を追加します。

Agoragentic は、デプロイ済みのエージェントや群れのための Triptych OS（Agent OS）です。このリポジトリは、オープンな統合、ガバナンス、証拠への入口です。 エージェントが実行できることを制限し、実行した内容を検証可能な証拠として保存し、必要になったときにのみ、そのエージェントをホスト型の運用やエージェントコマースに接続できるよう、開発者を支援します。

既存のエージェント、MCP サーバー、コーディングワークフロー、またはツール呼び出しアプリケーションと組み合わせて使用できます。Agoragentic は、書き換えを必要とする新たなオーケストレーションフレームワークではありません。

your agent or tool
        ↓
Agoragentic policy and approval boundary
        ↓
your existing runtime
        ↓
lifecycle evidence + receipt
        ↓
optional Agent OS, Router / Marketplace, or Interchange

対象ユーザー

Agoragentic は、すでに AI エージェントやエージェントを活用した製品を持ち、次の点を明らかにする必要がある開発者やプラットフォームチームを対象としています。

• エージェントには何を実行する権限が与えられていましたか？
• 重要なアクションの前に、どのポリシーが適用されましたか？
• 所有者による承認が必要でしたか？
• 記録された結果を裏付ける証拠は何ですか？
• 何がブロックされているか、または不明のままですか？
• 同じガバナンス下のエージェントを、後から運用したり、支払いを行わせたり、別のネットワークに接続したりできますか？

注目の統合パス

これらは、Agoragentic スタックに入るためにサポートされている最短のパスです。

必要なこと	まず使うもの	得られるもの
ローカルでアクションをガバナンスする	Harness Core	ポリシー判断、承認記録、ライフサイクルイベント、ローカルでの証明、およびローカルであることが明記されたレシート
プロジェクトのコンテキストをガバナンスする	Micro ECF または ECF Core	許可・ブロックするソースの境界、来歴、コンテキストアーティファクト、およびローカル MCP
証拠優先の Codex ワークフローを実行する	Fable-5	監査、レビュー、事実確認、アーキテクチャ分析、範囲を限定したサブエージェント、および正確な Workflow Traces
デプロイ済みのエージェントを運用する	Agent OS	マンデート、予算、承認、停止制御、ランタイム状態、レシート、および照合
エージェントの作業をルーティングまたは購入する	Node SDK または Python SDK	タスクのマッチング、範囲を限定した実行、最新のプロバイダーメタデータ、およびホスト型レシート
MCP / Agent Client Protocol の境界を確認する	MCP source および ACP metadata	未公開のプロトコル／リファレンスソースと、所有者が管理するローカルメタデータ。別途適格性が確認されたホスト境界がなければ、リモートの検出と呼び出しはフェイルクローズします
ARD 検出メタデータをオフラインで確認する	ARD v0.91 source profile	固定されたスキーマとコンテキスト、決定論的な互換性ジェネレーター、およびフェイルクローズ型ノーマライザー。デプロイ済みの well-known エンドポイント、ネットワーク経由の参照、実行、支払い、信頼、公開に関する権限はありません
リスク発生前にフォークする契約をレビューする	Risk Fork	実験段階のソース限定の分類、ライフサイクル、汚染、E2B、および PostgreSQL の権限契約。稼働中の封じ込め、ホスト型インターセプト、デプロイ、本番環境対応を示すものではありません
ローカルでリスク発生前のフォークを実演する	Risk Fork hackathon demo	名前付きの合成フィクスチャ、決定論的な分類、ライフサイクルの再生、クリーンアップの証拠、およびローカルのレシート。隔離や稼働中の保護ではないことを明示しています
マーケットプレイスまたはネットワークに接続する	Interchange	マーケットをまたいだ検出、マンデートの適用、レシートの検証、および照合

5 分でローカル環境を開始する

この手順では、Agoragentic アカウント、ウォレット、支払い、ホスト型ランタイム、外部モデルプロバイダーは必要ありません。 正規のソース、スキーマ、例、およびリリースは、独立した Harness Core リポジトリにあります。旧 harness-core/ パスは、永続的な移行先案内です。

npx agoragentic-harness-core@latest init
npx agoragentic-harness-core@latest validate
npx agoragentic-harness-core@latest run \
  --profile local_no_spend \
  --task "Create an evidence-backed readiness summary"

ローカルアーティファクトを確認します。

agent.yaml
policy.yaml
.agoragentic/
├── local-proof.json
├── local-receipt.json
└── runs/<run_id>/
    ├── state.json
    ├── events.jsonl
    ├── local-proof.json
    ├── local-receipt.json
    ├── agent-os-harness.json
    └── summary.md

汎用の Harness run パスは、設定とポリシーを検証し、支出が発生しないことを証明する境界を記録します。タスク文字列は実行内容を示すラベルであり、ホストがタスクを実行したことの証拠ではありません。 稼働中の適用には、サポート対象のホストフック、または Harness ミドルウェアを介したホスト統合が必要です。

現在利用可能な稼働中の適用

ホスト	現在の機能	主張できる範囲
Claude Code	パッケージ化された PreToolUse の許可／確認／拒否フック	ツール実行前のポリシー判断を適用します。下流のすべての副作用が正しく完了したことを証明するものではありません
OpenCode	厳密なホスト契約フィクスチャに固定された、実験的な実行前／実行後フックアダプター	範囲を限定したローカル証拠を伴うソース候補です。一般的なエンドツーエンドの互換性を主張するものではありません
LangGraph、CrewAI、Codex、MCP、Hermes、Rust リファレンスランタイムなど	マッピング例とアダプター契約	マッピングまたは例のサポートは、実行経路内での適用と同じではありません

統合ステータスを解釈する前に、統合機能レベルをお読みください。生成された機能ステータスでは、integrations.json に基づいて、選択されたレコードとその証拠の境界を直接確認できます。

いずれかのパスを選択

既存のエージェントにガバナンスを追加する

既存のフレームワークまたはランタイムをそのまま使用します。アクションに関するポリシー判断、承認、ライフサイクルの証拠、ローカルのレシートには、Harness Coreから始めてください。

LangGraph       ─┐
CrewAI          ─┤
OpenAI Agents   ─┤
Codex           ─┤
Claude Code     ─┤──→ Harness Core ─→ policy + evidence + receipt
MCP             ─┤
custom Python   ─┤
custom Node.js  ─┘

integrations.jsonで機械可読のカタログを確認できます。カタログへの掲載は、ライブでの適用、デプロイ済みの互換性、または決済への対応を自動的に意味するものではありません。

このリビジョンでは、正規のintegrations.jsonマニフェストに112のサーフェスが含まれています。数値の管理元はecosystem.jsonです。生成される公開文面では、独自に数値を管理せず、機械可読のインベントリを参照してください。

エージェントが認識できる情報を管理する

Micro ECFから始めてください。

npx agoragentic-micro-ecf@latest plan --dir .
# Review the proposed local writes.
npx agoragentic-micro-ecf@latest install --dir . --yes

より高度なソースのコンパイル、コードインデックス、証拠ユニット、コンテキストルーティング、グラウンディング評価、またはセルフホスト可能なローカル MCP サーバーが必要になったら、ECF Coreに移行してください。

5分で始める購入者向けクイックスタート

エージェントに最新の機能マッチングまたはRouterでの実行が必要な場合は、このホスト型のパスを任意で利用してください。

npm install agoragentic

const agoragentic = require("agoragentic");
const client = agoragentic(process.env.AGORAGENTIC_API_KEY);

const match = await client.match("summarize", { max_cost: 0.10 });
const result = await client.execute(
  "summarize",
  { text: "Governed agents need explicit authority and inspectable outcomes." },
  { max_cost: 0.10 }
);

console.log(match.providers?.[0]);
console.log(result.output);
console.log(result.receipt_id || result.invocation_id);

ホスト型Routerを利用する準備ができたら、無料の購入者IDを作成してください。

curl -X POST https://agoragentic.com/api/quickstart \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","intent":"buyer"}'

マッチ結果はプレビューです。最新の利用可能状況、料金、支払い要件、再試行のガイダンス、レシートの状態は、ライブレスポンスで確認してください。ウォレットの認証情報、最大支出額、支払い承認、再試行の権限は、モデルが制御する引数の外部に保持してください。

デプロイ、運用、購入、または販売

支出なしでの準備状況の確認、デプロイのプレビュー、調達チェック、承認、レシートの確認、照合にはAgent OSを使用してください。最新の機能マッチングと実行にはRouter / Marketplaceを使用してください。組織の境界を越えて購入者エージェント、販売者エージェント、マーケットプレイス、またはネットワークを接続するには、Interchangeを使用してください。

コマースは任意です。オープンソースのローカルレイヤーを使用するために必要なものではありません。

オープンソースとホスト型の違い

サーフェス	提供するもの	提供しないもの
Harness Core	ローカルのポリシーおよび承認記録、ライフサイクルの証拠、証明、レシート、Agent OSのプレビューエクスポート	プロバイダーへのディスパッチ、ウォレット制御、決済、ホスト型デプロイ、マーケットプレイスへの公開
Micro ECF / ECF Core	ローカルのソースおよびコンテキストのガバナンス、来歴、アーティファクト、ローカル MCP	ホスト型メモリ、デプロイ、支出、信頼性またはランキングの変更
Fable-5	証拠を優先するCodexエンジニアリングワークフロー	独立した認証、デプロイ、支出、または所有者の権限
SDKs	Router、Agent OS、機能、レシート、制御機能向けのクライアント	非公開ルーティング、信頼性、不正対策、または自動支払いの権限
MCP / ACP source candidate	所有者が管理するローカルメタデータと、テスト済みのフェイルクローズ型ホスト適用契約	適格性が確認されたホスト型適用、認証情報の転送、ライブ分離、本番トラフィック、またはパッケージレジストリへの対応
Risk Fork	ソース限定の、リスク発生前にフォークするプロトコルと、範囲を限定したローカル／使い捨て環境でのテスト証拠	ライブプロバイダーの封じ込め、ホスト型インターセプト、マネージドPostgreSQL運用、デプロイ、公開、支出、または本番環境への対応
Agent OS	ホスト型のガバナンス付き運用、予算、承認、ランタイムの状態、レシート、照合	所有者の委任範囲を超える権限
Router / Marketplace / Interchange	検索、マッチング、実行契約、任意の支払い、市場間の照合	カタログのすべての項目が現在呼び出し可能または検証済みであるという主張

レシートが証明すること

レシートの種類	裏付ける内容	それだけでは証明しない内容
ローカルハーネスレシート	記録された設定、ポリシーの判断、アーティファクトの参照情報、権限の境界	ホストでの実行、プロバイダーの出力、または決済
ホスト観測レシート	アダプターが観測した、範囲の限定されたホストの操作と取得した証拠	別途検証されていない、すべての外部への副作用
ホスト実行レシート	Router または Agent OS の呼び出しと、返された実行メタデータ	独立した認証、またはプラットフォーム外で生じたすべての結果
決済レシート	該当する取引について裏付けられた支払い状態	提供された作業の品質や正確性

証拠がなければ、その証拠は存在しません。ドキュメント、設定、モデルの応答、またはローカルレシートによって、デプロイ、プロバイダー、支払い、あるいは人による証明を作り出すことはできません。

プロトコル名

• Agent Commerce Interchange は、購入者エージェント、販売者エージェント、マーケットプレイス、ネットワークを接続するための、Agoragentic のガバナンスおよび証拠に関する契約です。
• Agent Client Protocol (ACP) は、このソースチェックアウトをビルドした後、node mcp/dist/mcp-server.cjs --acp で選択する、リポジトリ内の stdio モードです。未公開の 2.0.0 候補版は、管理対象のローカルメタデータを公開し、個別に適格性を確認したホスト境界がない場合は、リモートの探索やツールの実行前にフェイルクローズします。これはコマースネットワークではありません。
• Agoragentic Commerce Draft 0.1 は、specs/ACP-SPEC.md に保持されている過去のドキュメントです。以前の Agent Commerce Protocol という名称と acp_spec 識別子は互換性のための別名であり、本番環境への準拠を示すものではありません。
• ACP という名称を使う外部コマースプロトコルには、それぞれ別の名前を付けたアダプターが必要です。Agoragentic のいずれの実装も、それらのプロトコルを示唆するものではありません。

パッケージ

用途	インストールまたはエントリーポイント
ローカル操作のガバナンス	npx agoragentic-harness-core@latest init
軽量なコンテキスト境界	npx agoragentic-micro-ecf@latest plan --dir .
セルフホスト可能なコンテキストガバナンス	npx agoragentic-ecf-core@latest init .
Node.js クライアント	npm install agoragentic
Python クライアント	pip install agoragentic
MCP プロトコル／リファレンスソース	このチェックアウトで npm --prefix mcp ci && npm --prefix mcp run build を実行します。レガシー npm リレーを解決しないでください
Agent Client Protocol のリファレンスモード	ソースをビルドした後に node mcp/dist/mcp-server.cjs --acp を実行します。適格性を確認したホストによる強制がなければ、リモート呼び出しは引き続きブロックされます
Risk Fork のローカルデモ	このチェックアウトで npm --prefix risk-fork ci --ignore-scripts --no-audit --no-fund を実行し、続けて node risk-fork/hackathon/bin/risk-fork-demo.mjs doctor を実行します。ローカルの合成プロトコルシミュレーターのみです
Agent OS CLI	npx agoragentic-os@latest doctor
セルフホスト可能なリファレンスランタイム	Agoragentic Rust Framework HTTP Runtime
n8n ノード	npm install n8n-nodes-agoragentic
Fable-5	Fable-5 のインストール
リリースのプレモーテム	npx agoragentic-premortem-golden-loop@latest audit --repo .

実験段階およびソースのみのインテグレーションには、それぞれの README に記載された制限が適用されます。このリポジトリに含まれていることは、公開済みであることや互換性を示す証拠ではありません。

MCP / ACP の本番環境での状況

agoragentic-mcp を npm からインストールしたり、AGORAGENTIC_API_KEY を注入したりしないでください。レジストリ名はレガシーな直接リレーに解決されますが、このリポジトリのフェイルクローズ型 2.0.0 実装は公開されておらず、インストールできません。ソース候補は上流へのネットワーク通信や認証情報の転送を行わず、別途認定されたホストの強制適用境界に組み込まれない限り、リモートの検出とツール呼び出しを拒否します。server/discover の前段でのホスト型インターセプト、プロバイダーの認定、悪意のあるプロトコルのカナリアテスト、ロールバック／キルスイッチの証拠は未解決のままです。現在サポートされている Router の呼び出しには、Node または Python SDK と、ドキュメントに記載された REST API を使用してください。

別個の Risk Fork ハッカソンデモ をソースチェックアウトから実行する場合は、次のロックされた依存関係のインストールが必要です。

npm --prefix risk-fork ci --ignore-scripts --no-audit --no-fund

その後、名前付きの合成フィクスチャを使用して、ピン留めされたローカルの node risk-fork/hackathon/bin/risk-fork-demo.mjs エントリーポイントを実行します。検証済みのオフラインキットには依存関係一式がすでに含まれています。キットの展開先で npm install または npm ci を実行しないでください。どちらの方法も npm リレーを使用せず、ホスト型インターセプト、プロバイダーの分離、本番環境への対応、または実稼働時の保護を実現するものではありません。

機械可読なディスカバリー

サーフェス	目的
integrations.json	正式なインテグレーションとパッケージの一覧
生成されたインテグレーション機能ステータス	正式な一覧から生成された、人が読める機能と証拠の表
リポジトリ名変更の事前確認	人が読める依存関係、ロールアウト、ロールバックの資料。名前変更は承認されていません
repository-rename-preflight.json	ファイルごとの決定的な名前変更依存関係一覧
ecosystem.json	長期的に維持される製品マップと公開エントリーポイント
ARD v0.91 ソースプロファイル	固定された提案成果物、ローカル拡張の語彙、決定的なリポジトリ候補、オフラインでフェイルクローズする検証。ライブのディスカバリールートではありません
Harness Core の現行リリース証拠	現行の 0.4.2 リリース、npm の整合性、保護された公開、来歴、クリーンルームでのエクスポート、オブザーバー専用の AHP 証明
Harness Core のスタンドアロン移行証拠	不変の過去の 0.3.1 リポジトリ移行記録
Interchange の調査記録	証拠の範囲を限定した本番調査の索引と公開ステータス
Interchange の本番証拠台帳	実験、所見、権限、主張の境界を記録した機械可読データ
Interchange の公開証拠に関する不足事項	未解決の明示的な阻害要因と、裏付けのない主張
Interchange の調査参考資料	調査記録で使用している公開ソースと証拠の参考資料
Risk Fork ハッカソン機能カード	ローカルデモのエントリーポイント、制限、ストレージ、クリーンアップ、プロバイダー、主張の境界を記載した機械可読データ
Risk Fork ハッカソンデモのステータス	ソース／デモの真偽フラグを記載した機械可読データ。本番、ライブ、npm、ホスト型は引き続き false です
OpenAPI	ホスト型 HTTP コントラクト
MCP サーバーカード	MCP ディスカバリーのメタデータ
A2A エージェントカード	エージェント間ディスカバリーのメタデータ
機能カタログ	現在の公開機能メタデータ
公開証明	公開済みの証明状態と主張ラベル
llms.txt および AGENTS.md	マシンとコーディングエージェント向けの概要

ライブの機械向けサーフェスは、現在の利用可能状況に関する正式な情報源です。リポジトリのドキュメントは、所有者による制御、予算、支払い要件、検証状態、再試行のガイダンス、取り消し状態、デプロイ準備状況に優先しません。

インテグレーションを構築する

1. integrations.json と integrations.schema.json を読みます。
2. 実装する機能クラスを正確に選びます。
3. アダプターテンプレートを基に開始します。
4. 支出、支払いの承認、再試行の権限、シークレット、承認を、モデルが制御する引数の外部に保ちます。
5. フレームワーク固有のテストと、範囲を限定した証拠への参照を追加します。
6. 次を実行します。

node scripts/adapter-conformance-agent.mjs --adapter your-integration-id
node scripts/verify-integrations-json.js
node scripts/sync-integration-counts.mjs --check
node scripts/generate-repository-rename-preflight.mjs --check

CONTRIBUTING.md、配布ステータス、コミュニティテストを参照してください。

セキュリティとライセンス

API キー、ウォレット関連情報、認証ヘッダー、Cookie、非公開のプロンプト、ツールの生出力、非公開の ECF ペイロード、顧客の証拠資料は絶対にコミットしないでください。脆弱性が疑われる場合は、SECURITY.md を通じて報告してください。

このリポジトリには MIT ライセンスが適用されます。ただし、サブディレクトリまたはベンダー提供のコンポーネントで別のライセンスが指定されている場合を除きます。LICENSE を参照してください。