Agentready Mcp

@agentreadyweb/mcp

AgentReady とは？

AgentReady は、MCP を通じてあらゆるウェブサイトをエージェントから発見・利用できるようにする、ホスト型の機能レイヤーです。

URL を貼り付けると、AgentReady がサイトをクロールして、仕様に準拠した llms.txt を生成し、稼働中の /ask RAG エンドポイントと MCP サーバーをホストします。その後、MCP 対応のエージェントクライアントであれば、サイトを見つけ、自然言語で質問し、機能を調べ、引用付きの根拠に基づく読み取り専用プランを作成できます。

解決する問題： web_fetch を使う AI エージェントは、一度に 1 ページずつ取得するため、JavaScript の SPA（React、Next.js、Vue）から空の HTML を受け取り、回答が複数のページにまたがると幻覚を起こします。AgentReady はサイト全体をインデックス化し、JavaScript のレンダリングに対応して、ページを横断して情報を検索するため、エージェントは自信満々の誤答ではなく、正しい回答を得られます。

すでにインデックス化されているサイト： ライブの AgentReady ディレクトリ → をご覧いただくか、公開サイトを自分でインデックス化できます。

主な特長：

• 静的サイト、React／Next.js の SPA、Docusaurus、GitBook、独自エンジンなど、あらゆる公開 URL で動作します
• 最初のサイトのインデックス化にアカウントは不要です
• 共有インデックス — チームメンバーの誰かがサイトを登録すると、チーム全員がすぐに検索できます
• web_fetch では空の結果が返される、JavaScript でレンダリングされたページにも対応します
• 機能マニフェストで、鮮度、スキーマ、エンドポイント、読み取り専用の制限を確認できます
• 根拠に基づくプランでは、証拠、リスク、確認要件、永続的なレシートが返されます

CLI

同じパッケージを CLI としても利用できます。インストールもアカウントも不要です：

# Agent-readiness report card (llms.txt, sitemap, robots, JS-rendering, index status)
npx @agentreadyweb/mcp grade yourdocs.com

# Ask any site a question, get a cited answer (auto-indexes new sites in ~60s)
npx @agentreadyweb/mcp ask stripe.com "what is the test card number?"

# Index or re-crawl a site
npx @agentreadyweb/mcp index yourdocs.com
npx @agentreadyweb/mcp refresh yourdocs.com

CI、ダッシュボード、スクリプトで使う場合は、--json を追加すると、 生のレポートを標準出力に受け取れます（進行状況は標準エラー出力に表示されます）：

npx @agentreadyweb/mcp grade yourdocs.com --json | jq '.grade, .score'

評価が B を下回る場合、コマンドは引き続き終了コード 1 で終了します。

grade は評価が B を下回るとゼロ以外の終了コードを返すため、CI のゲートとして利用できます。ドキュメントのデプロイパイプラインで refresh を実行すると、インデックスを自動的に最新の状態に保てます：

# GitHub Actions — after your docs deploy step
- run: npx @agentreadyweb/mcp refresh yourdocs.com

---

MCP 対応クライアントを AgentReady に接続します：

ローカル MCP ブリッジ（stdio）

mcpServers 設定を使用するクライアントの場合、AgentReady ブリッジを追加します：

{
  "mcpServers": {
    "agentready": {
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

クライアントを再起動してください。次の 8 つのツールを利用できます：

• list_sites — インデックス化されたすべてのウェブサイトを表示します
• get_site_capabilities — 必要に応じてインデックス化した後、サイトのマニフェスト、鮮度、スキーマ、エンドポイントを確認します
• get_site_facts — サイトから抽出された主要な構造化情報を取得します
• ask_site — 引用付きの複数ページにわたる回答で、あらゆるサイトに質問します
• plan_site_action — 必要に応じてインデックス化した後、根拠に基づく読み取り専用プランとレシートを作成します
• submit_site — 検索できるようにウェブサイトをインデックス化します
• refresh_site — サイトを再クロールします。新しいサイトの場合は初回のインデックス化を行います
• rate_answer — 回答の品質に関するフィードバックを送信します

Cursor

~/.cursor/mcp.json に追加します：

{
  "agentready": {
    "command": "npx",
    "args": ["-y", "@agentreadyweb/mcp"]
  }
}

プロジェクトまたはターミナルの設定

npx @agentreadyweb/mcp

または、同じ agentready サーバーをクライアントのプロジェクト設定に追加して、チームで共有します：

{
  "mcpServers": {
    "agentready": {
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

VS Code（GitHub Copilot エージェントモード）

GitHub Copilot 拡張機能を備えた VS Code 1.99 以降が必要です。プロジェクトのルートに .vscode/mcp.json を作成します：

{
  "servers": {
    "agentready": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

Copilot の MCP ツールはエージェントモードでのみ利用できます。チームで共有するには、このファイルをコミットしてください。

Windsurf／Zed／その他のクライアント

stdio トランスポートに対応する MCP クライアントであれば、同じ方法で動作します。コマンドとして npx -y @agentreadyweb/mcp を使用してください。

WebMCP（インストール不要）

クライアントが HTTP トランスポートに対応している場合、URL で直接接続できます。npm は不要です：

https://www.agentready.it.com/api/mcp

Docusaurus プラグイン

ドキュメントサイトで Docusaurus を使用している場合、ビルドのたびに自動でインデックス化できます：

npm install @agentreadyweb/docusaurus-plugin

// docusaurus.config.js
plugins: [
  ['@agentreadyweb/docusaurus-plugin', { domain: 'docs.yoursite.com' }]
]

MkDocs プラグイン

ドキュメントサイトで MkDocs を使用している場合、ビルドのたびに自動でインデックス化できます：

pip install mkdocs-agentready

# mkdocs.yml
plugins:
  - search
  - agentready

site_url が設定されていない場合は、ドメインを明示的に指定してください：

plugins:
  - agentready:
      domain: docs.yoursite.com

Starlight プラグイン

ドキュメントサイトで Starlight（Astro）を使用している場合は、ビルドのたびに自動でインデックスを作成します。

npm install starlight-agentready

// astro.config.mjs
import agentready from 'starlight-agentready'

export default defineConfig({
  site: 'https://docs.yoursite.com',
  integrations: [
    starlight({
      plugins: [agentready()],
    }),
  ],
})

Sphinx 拡張機能

ドキュメントサイトで Sphinx を使用している場合は、ビルドのたびに自動でインデックスを作成します。

pip install sphinx-agentready

# conf.py
extensions = [
    "sphinx_agentready.extension",
]

# Domain is inferred from html_baseurl automatically, or set explicitly:
agentready_domain = "docs.yoursite.com"

利用可能なツール

list_sites

AgentReady によって現在インデックス化されているすべてのウェブサイトを、タイトルとページ数とともに一覧表示します。ドメインを送信する前に、すでに利用可能かどうかを確認するために使用します。

get_site_capabilities

get_site_capabilities(domain: string)

サイトの機能マニフェスト、鮮度の状態、スキーマ、および利用可能な HTTP／MCP エンドポイントを返します。

get_site_facts

get_site_facts(domain: string)

サイトから抽出した主要な構造化情報（料金プラン、機能一覧、制限事項、その他エージェントが頻繁に必要とする重要度の高いデータポイント）を返します。

plan_site_action

plan_site_action(domain: string, request: string)

根拠、リスク、確認要件、および永続的なレシートを含む、根拠に基づいた読み取り専用のプランを作成します。副作用を伴う操作は実行しません。

submit_site

submit_site(url: string)

AgentReady で任意のウェブサイトをインデックス化します。所要時間は約 60 秒です。4 層のパイプラインを通じて、静的サイト、サーバーサイドレンダリングのページ、JavaScript を多用する SPA に対応します。完了後は ask_site で問い合わせることができます。

例： submit_site("https://docs.example.com")

ask_site

ask_site(domain: string, query: string, url?: string)

任意のウェブサイトについて質問し、そのコンテンツに基づく引用付きの回答を取得します。複数のページにわたる情報を統合します。サイトがまだインデックス化されていない場合は、回答の前に AgentReady が自動でクロールしてインデックスを作成します（約 60 秒）。

例： ask_site("stripe.com", "What are the fees for card payments?")

refresh_site

refresh_site(domain: string)

サイトを完全に再クロールして、新規または変更されたコンテンツを取得します。新しいサイトの場合は、AgentReady が初回のインデックスを自動で作成します。所要時間は約 60 秒です。

例： refresh_site("docs.example.com")

rate_answer

rate_answer(domain: string, rating: number, request_id?: string, comment?: string)

品質に関する 1～5 の評価を送信します。必要に応じて、該当する ask_site リクエストに紐付けることもできます。

デプロイ webhook

デプロイのたびにドキュメントを自動で再インデックス化します。認証は不要です。ドメインごとに 1 時間に 1 回までに制限されています。

curl -X POST https://www.agentready.it.com/api/webhook/refresh \
  -H "Content-Type: application/json" \
  -d '{"domain": "docs.yoursite.com"}'

または、クエリパラメーターでドメインを渡すこともできます（Vercel／Netlify のフォームエンコードされた webhook ペイロードで動作します）。

https://www.agentready.it.com/api/webhook/refresh?domain=docs.yoursite.com

インデックス作成の仕組み

AgentReady は、あらゆる公開ウェブサイトに対応するため、階層型のアプローチを採用しています。

1. llms.txt / llms-full.txt — サイトで公開されている場合は、高品質な構造化コンテンツソースとして使用します
2. 標準 HTML クロール — サイトマップまたはリンクのクロールを通じて最大 10 ページを取得し、クリーンなテキストを抽出します
3. __NEXT_DATA__ の抽出 — Next.js アプリの場合、HTML に埋め込まれたサーバーサイドレンダリングデータを解析します
4. Jina Reader によるフォールバック — 空の HTML を返す JS のみの SPA の場合、リモートレンダリングサービスを使用してコンテンツを抽出します

認証が必要なサイトや、公開 HTML コンテンツがないサイトはインデックス化できません。

環境変数

変数	デフォルト値	説明
AGENTREADY_MCP_URL	https://www.agentready.it.com/api/mcp	MCP エンドポイントを上書きします（セルフホストの場合）
AGENTREADY_TELEMETRY	1	匿名の利用状況テレメトリーを無効にするには 0 を設定します

テレメトリー

このパッケージは、MCP ブリッジの起動時または CLI コマンドの実行時に、agentready.it.com/api/telemetry へ軽量な匿名 ping を送信します。送信される情報は、ランダムなインストール ID（~/.agentready/install-id に保存）、パッケージのバージョン、Node のバージョン、プラットフォーム、および使用したモード／コマンドです。質問の内容、ドメイン名、個人データは送信されません。オプトアウトするには AGENTREADY_TELEMETRY=0 を設定します。