Agent Ready

agent-ready-mcp

Agent Ready 向けの MCP サーバーです。Vercel Agent Readability Spec、llmstxt.org 標準、およびエージェントプロトコルのマニフェスト（MCP サーバーカード、A2A、agents.json、agent-permissions.json、UCP、x402、NLWeb）に照らして、任意の URL が AI エージェントにとって読み取りやすいかをスキャンします。4 つの仕様ファミリーにわたる 72 項目のチェックを実施します。内訳は、サイトとページのチェックが 40 項目（サイト全体が 15 項目、ページごとが 25 項目）、llmstxt.org のチェックが 10 項目、エージェントプロトコルマニフェストのチェックが 22 項目です。各チェックには修正のガイダンスが付属します。また、WCAG 2.2 とレイアウト安定性に関する 23 項目のチェックによる、独立したアクセシビリティのサブスコアも提供します。

https://agent-ready.dev/api/v1/mcp（Streamable HTTP）でホストされています。このパッケージは同じ REST エンドポイントを利用する軽量な stdio ラッパーで、ローカル MCP クライアント（Claude Desktop、Claude Code、Cursor、VS Code、Windsurf）向けに npm で配布されています。

機能

• scan_site — 任意の URL を新たにスキャンし、エージェントにとっての読み取りやすさを評価します。匿名の無料枠ではキーなしで利用できます（IP ごとに 30 日間で 3 回、深度 25 ページ、同期実行）。Pro キーを使用すると、最大 250 ページをスキャンし、ホストされた API を最大 60 秒間ポーリングします。
• get_scan — ID を指定して、以前に実行したスキャンを取得します（Pro キーが必要です。スキャン履歴はアカウントごとに管理されます）。
• ask — Agent Ready 独自の方法論、チェック項目、仕様を対象とした自然言語（NLWeb）検索です。公開されており、API キーは不要です。Schema.org 型付きの結果を返します。
• validate_structured_data — ページ上、または貼り付けた JSON-LD を Agent Ready の構造化データチェックで検証します。公開されており、API キーは不要です。貼り付けモードではネットワーク接続が不要なため、エージェントは作成したばかりの JSON-LD を検証できます。
• 3 つのディスカバリープロンプト — scan、interpret_scan、remediation_plan。URL からスコアの取得、修正計画の作成までを一貫して行うワークフローです。
• SKILL.md — アクティベーションのルーティングに使う Claude Skill 記述子が skills/agent-ready/ に含まれています。

セットアップ

利用開始にキーは不要です。scan_site、ask、validate_structured_data はすべて、初期状態から匿名で利用できます（scan_site は匿名無料枠で利用でき、IP ごとに 30 日間で 3 回、深度 25 ページです）。Agent Ready Pro API キーを使うと、月 50 回のスキャン、深度 250 ページ、スキャン履歴（get_scan）、週次モニタリングが利用できます。agent-ready.dev で登録し、ダッシュボードからキーを発行してください。以下の設定にある env ブロックは任意です。キーを使わない場合は省略してください。

Claude Desktop

（macOS）~/Library/Application Support/Claude/claude_desktop_config.json または（Windows）%APPDATA%\Claude\claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "agent-ready": {
      "command": "npx",
      "args": ["-y", "agent-ready-mcp@latest"],
      "env": {
        "AGENT_READY_API_KEY": "ar_live_..."
      }
    }
  }
}

Claude Code

claude mcp add agent-ready \
  -e AGENT_READY_API_KEY=ar_live_... \
  -- npx -y agent-ready-mcp@latest

Cursor / VS Code / Windsurf

.cursor/mcp.json、.vscode/mcp.json、または ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "agent-ready": {
      "command": "npx",
      "args": ["-y", "agent-ready-mcp@latest"],
      "env": {
        "AGENT_READY_API_KEY": "ar_live_..."
      }
    }
  }
}

環境変数

変数	必須	デフォルト	用途
AGENT_READY_API_KEY	いいえ	—	Agent Ready ダッシュボードで発行する Pro Bearer トークンです。設定しない場合、scan_site は匿名無料枠を使用し、get_scan は利用できません。
AGENT_READY_API_URL	いいえ	https://agent-ready.dev	セルフホスト環境またはステージング環境で使う URL を指定します。
AGENT_READY_SCAN_TIMEOUT_MS	いいえ	60000	scan_site が running のプレースホルダーを返すまでのポーリング時間です。
AGENT_READY_GET_TIMEOUT_MS	いいえ	5000	get_scan およびポーリングごとのフェッチのタイムアウトです。

ツール

ツール	入力	戻り値
scan_site	url（文字列、必須）、pageLimit（数値、省略可、最大 2000 — プランに応じて上限あり。キーなしの場合は 25 に固定）	スキャンオブジェクト：Vercel スコア 0～100、llms.txt サブスコア 0～100、howToFix 文字列を含むチェックごとの検出結果。キーなしでの実行は匿名の無料枠（IP あたり 30 日間で 3 回のスキャン）を使用し、同期的に結果を返します。Pro キーを使用し、スキャンがポーリングの期限を超えた場合は、プレースホルダー { id, status: "running" } を返します。
get_scan	id（文字列、以前の scan_site 呼び出しで取得したスキャン ID）	scan_site と同じスキャンオブジェクト。不明な ID、または認証済みユーザーに属さない ID の場合は not_found を返します。Pro キーが必要です。
ask	q（文字列、必須）、itemType（省略可、コーパスフィルター）、mode（省略可、list または summarize）	Agent Ready の方法論、チェック項目、仕様を対象とする NLWeb /ask。公開されており、API キーは不要です。Schema.org 型付きの結果オブジェクトを返します。
validate_structured_data	url（文字列）または jsonld（文字列）のどちらか一方のみ	D シリーズの構造化データ結果：mode、url、チェックごとの検出結果、判定を示す summary。公開されており、API キーは不要です。ファーストパーティのバリデーターでは対応していないスキーマの lint とエージェントとの整合性を検証します。

プロンプト

プロンプト	引数	説明
scan	url	新規スキャンと概要（スコア、評価、主な失敗項目 3～5 件、次のステップ）。
interpret_scan	id	以前のスキャン結果をカテゴリ別にまとめ、平易な言葉で説明します。
remediation_plan	id、省略可の focus（"seo" または "agents"）	Now／Next／Later の区分と修正ごとのチェック ID を含む、優先順位付きの修正計画書。

ワークフローの例

You: Use agent-ready to scan https://my-saas.com
Claude: [calls scan_site] Your site scored 78/100 (Good) on the Vercel Agent
        Readability Spec. The top 3 fixes: …
You: Can you build me a remediation plan?
Claude: [calls remediation_plan with the scan id] Here's the prioritised list…

スキル（Anthropic Claude Skills）

パッケージ内の skills/agent-ready/SKILL.md に SKILL.md があります。Claude Desktop／Claude Code で使用するには、skills/agent-ready/ ディレクトリを ~/.claude/skills/ にコピーしてください。

このスキルでは、いつ有効にするか（URL と可読性監査の意図）、どのツールを選ぶか、生の JSON をそのまま出力せずにスキャン結果を提示する方法、他のツール（一般的な SEO、パフォーマンスプロファイリング、コード編集）に任せるタイミングについて説明します。

仕組み

このパッケージは、stdio から HTTPS への薄いラッパーです。

MCP client (stdio) ↔ agent-ready-mcp ↔ HTTPS ↔ agent-ready.dev/api/v1/scans

すべてのスキャン実行、永続化、Pro プランのクォータ適用はホストサーバー上で行われます。npm パッケージは、stdio 上の MCP JSON-RPC と REST API の間を変換するだけです。

ローカルにインストールせず、ホストされた MCP サーバーを直接（Streamable HTTP トランスポートで）使用する場合は、MCP クライアントの接続先を https://agent-ready.dev/api/v1/mcp に設定し、Authorization: Bearer ar_live_... を指定してください。

方法論

72 件のチェック、その重み付け、スコアの計算式については、agent-ready.dev/methodology に記載されています。このリポジトリの manifest.json と server.json は、関連するレジストリスキーマ（それぞれ Glama Marketplace v0.3 と MCP registry 2025-12-11）に準拠しています。

開発

npm install
npm run build       # → dist/mcp-server.mjs
npm test
npm run typecheck

リリース

RELEASE.md を参照してください。バージョンの適用箇所、ローカルチェック、タグのプッシュ、GitHub Actions のリリースワークフロー、リリース後の手動手順については、このファイルが正式な情報源です。

ライセンス

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