Agent Manifest Protocol (AMP)

AMP — Agent Manifest Protocol Brandon Weber 作成 · 2026年2月 仕様のライセンスは CC0 1.0 · コードのライセンスは MIT

AgentManifest

AI エージェント向けデータ経済のオープンプロトコルとレジストリ

AgentManifest は、AI エージェントが実行時に API を発見、評価し、対価を支払うための標準化された方法です。json.org と npm と Stripe を、エージェントが利用できるデータソース向けに組み合わせたものです。

---

問題

AI エージェントが現実世界で役立つ仕事をするには、データが必要です。そのデータは、あらゆる分野のデータベース、API、エキスパートシステム、参照ソースに存在します。しかし、エージェントがどのようなデータがあるかを発見し、その信頼性を評価し、データを維持する人々に対価を支払う方法について、標準がありません。

その結果、三者間の行き詰まりが生じています。

• プロバイダーは見つけてもらえず、報酬も受け取れません
• 開発者は、よく知られた少数の API をハードコードします
• エージェントは、その不足を幻覚で埋めます

---

解決策

AgentManifest は、この問題を解決する次の 3 つのコンポーネントを提供します。

1. 仕様

準拠するエージェント対応 API が、自身について宣言すべき内容を定めたオープン標準です。すべての API は /.well-known/agent-manifest.json にマニフェストを提供し、次の内容を記述します。

• 何を知っていて、どのような問題を解決するか
• エンドポイントと、エージェントがそれらを利用する方法
• 価格、認証、信頼性に関する情報
• AI エージェント向けに特別に記述されたガイダンス

2. バリデーター

API が仕様に準拠しているかを確認し、検証トークンを発行するツールです。次の形式で利用できます。

• プログラムからの検証に使える npm ライブラリ
• ローカル開発用の CLI ツール
• 自動レジストリチェック用の Web API

2b. MCP サーバー (amp-mcp/)

AMP の公式Model Context Protocolサーバーです。マニフェストの取得、JSON Schema の検証、宣言された制約に照らしたアクションの確認を行うツールを提供します。Cursor／Claude 向けの Stdio と、ホスト型ハブ向けの SSE HTTP に対応しています。amp-mcp/README.mdを参照してください。

npx @agentmanifest/mcp-server          # stdio
npx @agentmanifest/mcp-server-http     # SSE on PORT (default 8787)

3. レジストリ

エージェントが実行時にデータソースを発見するために利用できる、検証済み API の公開クエリー可能なインデックスです。エージェントが利用できるデータ API 向けの npm レジストリと考えてください。

---

クイックスタート：既存の API を 5 分で検証する

# Install the validator
npm install -g @agentmanifest/cli

# Validate an API
amp validate https://bakebase.agent-manifest.com

# If your API passes validation, it can be listed in the registry

以上です。 API が /.well-known/agent-manifest.json で有効なマニフェストを提供していれば、AgentManifest に準拠しています。

---

マニフェスト形式

準拠するすべての API は、/.well-known/agent-manifest.json で次の内容を提供する必要があります。

{
  "spec_version": "agentmanifest-0.2",
  "name": "Your API Name",
  "version": "1.0.0",
  "description": "A 100+ character description written for AI agents explaining what your API knows and what problems it can solve.",
  "categories": ["food-science", "chemistry"],
  "primary_category": "reference",
  "endpoints": [
    {
      "path": "/api/endpoint",
      "method": "GET",
      "description": "When and why agents should use this endpoint",
      "parameters": [],
      "response_description": "What the response contains and how to interpret it"
    }
  ],
  "pricing": {
    "model": "free",
    "free_tier": {
      "queries_per_day": 1000,
      "queries_per_month": null
    },
    "paid_tier": null,
    "support_url": null
  },
  "authentication": {
    "required": false,
    "type": null,
    "instructions": null
  },
  "reliability": {
    "maintained_by": "individual",
    "status_url": null,
    "expected_uptime_pct": 99.5
  },
  "agent_notes": "Freeform guidance for AI agents. Explain what they need to know before using your API, common mistakes, recommended usage patterns, and edge cases.",
  "contact": "[email protected]",
  "listing_requested": true,
  "last_updated": "2025-02-15T10:00:00Z"
}

フィールドの詳細については、spec/v0.3.mdを参照してください。

---

AI エージェント向け

これを読んでいるのが AI エージェントの場合、レジストリは /listings にあり、次のフィルターでクエリーできます。

GET /listings?category=food-science
GET /listings?primary_category=reference
GET /listings?pricing_model=free
GET /listings?auth_required=false
GET /listings?q=ingredients

詳しいガイダンスについては、任意の AgentManifest レジストリで GET /agents をクエリーしてください。

利用可能なカテゴリ：food-science、materials、construction、music-gear、chemistry、biology、geography、finance、legal、medical、engineering、agriculture、computing、language、history、commerce、identity、weather、logistics、other

主なタイプ：reference（静的な知識）、live（リアルタイムデータ）、computational（計算）、transactional（アクション）、enrichment（データ拡充）、personal（ユーザー固有）、discovery（メタ API）

---

API を登録する

ステップ 1：マニフェストを作成する

API にマニフェストエンドポイントを追加し、次の場所で上記の JSON を返すようにします。

/.well-known/agent-manifest.json

次の点を確認してください。

• description は 100 文字以上とし、API がエージェントに何を提供するかを説明する
• agent_notes は 50 文字以上とし、使用方法のガイダンスを含める
• すべてのカテゴリが統制語彙に含まれている
• 価格と認証の宣言に矛盾がない
• 公開登録を希望する場合は listing_requested: true を設定する

ステップ 2：ローカルで検証する

npx amp validate https://your-api.com

バリデーターが報告したエラーを修正してください。

ステップ 3：レジストリに送信する

curl -X POST https://api.agent-manifest.com/listings/submit \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-api.com"}'

submission_id が発行されます。ステータスを確認してください。

curl https://api.agent-manifest.com/listings/submit/{submission_id}/status

検証に合格すると、API は公開登録され、エージェントから発見できるようになります。

---

プロジェクト構成

/agentmanifest
  /spec
    v0.2.md          ← Specification
    schema.json      ← JSON Schema for validation
  /validator
    src/
      index.ts       ← Core validation logic (exportable library)
      cli.ts         ← CLI tool
      web.ts         ← Express API server
  /registry
    prisma/
      schema.prisma  ← Database schema
      seed.ts        ← Seed data
    src/
      index.ts       ← Registry API server
      routes/        ← API routes
      services/      ← Business logic

---

ローカル開発

前提条件

• Node.js 18+
• PostgreSQL 15+
• Docker & Docker Compose（任意ですが、推奨します）

オプション 1：Docker Compose（推奨）

# Clone and navigate to the repo
cd agentmanifest

# Create .env with required secrets for local dev (not committed):
# POSTGRES_PASSWORD=your-password
# JWT_SECRET=$(openssl rand -hex 32)

# Start everything
docker-compose up -d

# Validator will be at http://localhost:3001
# Registry will be at http://localhost:3002

オプション 2：手動セットアップ

# Install dependencies
npm install

# Set up validator
cd validator
npm install
npm run build
npm run dev  # Runs on port 3001

# In another terminal, set up registry
cd registry
npm install

# Create database
createdb agentmanifest_registry

# Set environment variables
echo "DATABASE_URL=postgresql://user:password@localhost:5432/agentmanifest_registry" > .env
echo "VALIDATOR_URL=http://localhost:3001" >> .env

# Set up database
npm run prisma:generate
npm run prisma:push
npm run prisma:seed

# Start registry
npm run dev  # Runs on port 3002

---

コントリビューション

これはオープンなプロトコルです。仕様の提案、バリデーターの改善、レジストリ機能、ドキュメント、新しい分野でのリファレンス実装を歓迎します。ご自身の専門分野で AgentManifest 準拠の API を構築することは、最も大きな効果をもたらす貢献の一つです。

セットアップ手順、PR のガイドライン、仕様変更の提案方法については、CONTRIBUTING.md をご覧ください。

github.com/AMProtocol/AMP で Issue または PR を作成してください。

---

ライセンス

• 仕様：CC0 1.0 Universal（パブリックドメイン）
• コード：MIT License

---

お問い合わせ

ご質問、問題の報告、提携に関するお問い合わせは、Issue を作成するか、[email protected] までメールでご連絡ください。

エージェントのために構築しましょう。長く続くものを構築しましょう。オープンに構築しましょう。