RealWorldAPIs

RealWorldAPIs MCP

RealWorldAPIs は、物理世界と接続する AI エージェント向けの、エビデンスを重視した API レジストリです。

現実世界の API は、ソフトウェアや AI エージェントを、物理世界を表すデータ、デバイス、インフラストラクチャ、サービスに接続します。対象には、天気、地図、モビリティ、物流、IoT、エネルギー、ロボティクスなどがあります。

このリポジトリでは、RealWorldAPIs の、公開状態を確認できる MCP インターフェースの実装について説明し、提供しています。

現在のツール、スキーマ、推奨の動作、エビデンスの意味については、ホストされた RealWorldAPIs のライブサービスが正となる情報源です。ホストされたサービスは、このリポジトリで確認できるコードとは独立して進化する場合があります。

サービス全体を通じて、次の基本的なエビデンスルールが適用されます。

不明は不明のままであり、確認済みのサポートとして扱われることはありません。

公開インターフェースと独自のインテリジェンス

RealWorldAPIs は、公開された相互運用性のためのインターフェースと、独自の意思決定システムを意図的に分離しています。

公開／相互運用性のためのインターフェース

以下は、公開され、相互運用性のために利用できることを意図しています。

• リモート MCP エンドポイントとツールスキーマ
• 公開 HTTP エンドポイントと OpenAPI の説明
• 公開 API カタログと機能／エビデンスの出力
• 公開ドキュメントと使用例
• 事実に基づくプロバイダーのメタデータとエビデンスへのリンク
• ホストされたサービスが返す、構造化された推奨結果と検証結果

独自のホスト型システム

以下は、このリポジトリを通じて公開またはライセンスされるものではありません。

• 正規版 RealWorldAPIs の推奨・ランキングエンジン
• 自然言語によるタスク解析とタスクフレームのロジック
• 機能の検索、統合、および関連機能の再ランキングのロジック
• 内部スコアリングルール、重み付け、最適化ロジック
• 検証とエビデンス処理の実装
• アサーション生成と調査のパイプライン
• ベンチマークツール、非公開の評価セット、ホールドアウトセット
• 内部管理、提案、承認のシステム

MCP レイヤーは、推奨やエビデンスに基づく意思決定支援のために、ホストされた正規版 RealWorldAPIs サービスを呼び出します。インターフェース、スキーマ、結果を公開しても、その基盤となるホスト型実装が公開されるわけではありません。

リポジトリの権利に関する通知については、PROPRIETARY_NOTICE.md を参照してください。

ライブサービス

• ウェブサイト： https://realworldapis.com
• リモート MCP エンドポイント： https://mcp.realworldapis.com/mcp
• MCP のヘルスチェック： https://mcp.realworldapis.com/health
• カタログ JSON： https://realworldapis.com/api/catalog.json
• 機能 JSON： https://realworldapis.com/api/capabilities.json
• 要件の検証： https://realworldapis.com/api/verify-requirement
• 構造化された推奨： https://realworldapis.com/api/recommend
• OpenAPI： https://realworldapis.com/openapi.json
• LLM 向け完全カタログ： https://realworldapis.com/llms-full.txt
• 調査： https://realworldapis.com/research/state-of-agent-ready-apis-2026

現在、公開 MCP ツールの検出や呼び出しに RealWorldAPIs API キーは必要ありません。

MCP ツール

現在、ライブの RealWorldAPIs MCP サービスは、読み取り専用ツールを 6 つ公開しています。

ツール	用途
find_api_for_task	ホストされた正規版レコメンダーを使って自然言語で API を選択し、その後、返された候補を制約付きで比較します。
search_apis	正規 API フィールドに基づいて、決定論的な検索と絞り込みを行います。
search_capabilities	検証済みの機能グラフを直接検索します。
verify_requirement	特定の要件に対する 1 つの API を、エビデンスに基づいて YES／NO／PARTIAL／UNKNOWN で検証します。
get_api	スラッグまたは名前を指定して、正規 API の意思決定プロファイルを 1 つ取得します。
compare_apis	正規フィールドを決定論的に左右で比較します。

ライブのツールセットとスキーマが正式な情報源です。このリポジトリでソースコードを確認できる実装は、ホストされたサービスより遅れている場合があります。

どのツールを使えばよいですか？

必要なこと	使用するもの
自由形式の自然言語によるタスクや望ましい結果についての推奨	find_api_for_task
カテゴリ、機能、プロトコルの状況、または準備状況による厳密な絞り込み	search_apis
検証済みのタスクレベルの機能を直接検索	search_capabilities
厳密な API 要件について、証拠に基づいて判定	verify_requirement
すでに特定されている API の正式なレコード	get_api
すでに特定されている候補を項目ごとに比較	compare_apis

find_api_for_task

ユーザーが特定の API ではなく、目標を説明している場合に使用します。

タスクの例：

{
  "task": "I need my agent to connect to a car and predict weather on the route"
}

正式なホスト型レコメンダーが返す構造化された候補リストが、信頼できる唯一の情報源です。AI による比較はその候補リストに限定され、リスト外の API を追加することはできません。

search_apis

レジストリを直接絞り込めるほどタスクが明確な場合に使用します。

例：

{
  "categories": ["Geospatial"],
  "agent_capabilities": ["locate"],
  "mcp": "Yes",
  "min_readiness": 60,
  "limit": 10
}

明示的に保存された値のみを使用します。たとえば、mcp: "Yes" は、MCP の状況が Unknown の API では条件を満たしません。

search_capabilities

タスクを広範な API カテゴリではなく、厳密な機能や実行要件として表現したほうが適切な場合に使用します。

機能の検索結果には、正式な証拠グラフで確認できる場合、実行、アクセス、承認、ハードウェア、サンドボックス、物理的影響、および可逆性に関するフィールドが含まれることがあります。

verify_requirement

1 つの API が 1 つの厳密な要件を満たすか判定する場合に使用します。

例：

{
  "api": "here-location-services",
  "requirement": "truck routing in Sweden"
}

検証ツールは、証拠に基づいた YES、NO、PARTIAL、または UNKNOWN の結果を返します。Unknown が、明示されないままサポートありと判定されることはありません。

get_api

例：

{
  "identifier": "geoapify"
}

応答は、プロバイダーのメタデータ、機能、認証、プロトコルの状況、および証拠へのリンクを含む、RealWorldAPIs の正式な判定プロファイルです。

compare_apis

例：

{
  "apis": ["Geoapify", "Google Maps Platform", "Mapbox"],
  "fields": [
    "category",
    "capabilities",
    "agent_capabilities",
    "auth_methods",
    "openapi",
    "mcp",
    "agent_readiness_score"
  ]
}

比較は決定的に行われます。RealWorldAPIs は、不足しているサポートを推測したり、Unknown を推測で置き換えたりしません。

接続

リモート Streamable HTTP に対応した MCP クライアントであれば、次に接続できます。

https://mcp.realworldapis.com/mcp

MCP 設定の例：

{
  "mcpServers": {
    "realworldapis": {
      "url": "https://mcp.realworldapis.com/mcp"
    }
  }
}

Codex 形式の TOML

[mcp_servers.realworldapis]
url = "https://mcp.realworldapis.com/mcp"

証拠モデル

RealWorldAPIs は、自由形式の API 推奨ではなく、正規化された証拠レイヤーを中心に設計されています。

正式なデータセットでは、次のようなフィールドを管理しています。

• プロバイダーとカテゴリ
• 検証済みのタスクレベルの機能
• エージェントのアクションプリミティブ
• 認証方式
• OpenAPI
• MCP
• A2A
• x402
• llms.txt
• 公開ドキュメントの状況
• 認証の検証状況
• アクセス要件とセットアップ要件
• 承認要件
• ハードウェア依存関係
• サンドボックスの利用可否
• 物理的影響
• 不可逆性
• 直接的な証拠へのリンク

根拠に関するルール

1. 正式な構造化データセットが信頼できる唯一の情報源です。
2. Unknown は No と異なります。
3. AI による比較では、構造化された候補リスト外の API を追加できません。
4. 検索ツールと比較ツールは、正式に保存された証拠を使用します。
5. プロバイダーに関する確定的な事実には、RealWorldAPIs の証拠ポリシーで定められた適切な品質の証拠が必要です。
6. 本番環境に統合する前に、プロバイダーのドキュメントを確認してください。

RealWorldAPIs が存在する理由

一般的な API ディレクトリは幅広い検索に役立ちますが、AI エージェントには、次のような質問に答えるための正規化された方法がますます必要になっています。

• このタスクを実行できる、具体的な API 機能はどれですか？
• 車両を特定し、技術者の経路を案内できる API はどれですか？
• エージェントが操作でき、機械可読な形式にも対応する気象 API はどれですか？
• 機械で利用できるインターフェースを公開しているロボティクス API はどれですか？
• 物理世界に関わるワークフローのために組み合わせられる API はどれですか？
• アクセス、承認、ハードウェア、または安全性に関する制約は何ですか？
• エージェントがプロバイダーを信頼する前に、どのような証拠の不足を解消する必要がありますか？

RealWorldAPIs は、ソフトウェアとエージェントを物理世界につなぐ API に特化しています。

調査とデータセット

公開調査ページ State of Agent-Ready Real-World APIs 2026 では、エージェント対応状況、プロトコルのサポート状況、カテゴリ別の根拠に関するカタログのスナップショットをまとめています。

https://realworldapis.com/research/state-of-agent-ready-apis-2026

機械可読な調査データ：

https://realworldapis.com/research/state-of-agent-ready-apis-2026.json

公開カタログはこちらから利用できます：

https://realworldapis.com/api/catalog.json

検証済みの機能グラフはこちらから利用できます：

https://realworldapis.com/api/capabilities.json

アーキテクチャ

この MCP サーバーは、正規のホスト型 RealWorldAPIs サービスのインターフェース層として機能するよう意図的に設計されています。

MCP client
   |
   +-- find_api_for_task --------> hosted canonical recommender
   +-- verify_requirement --------> hosted evidence/verifier layer
   +-- search_capabilities -------> canonical capability graph
   +-- search_apis ---------------> canonical API catalog
   +-- get_api -------------------> canonical API decision profile
   +-- compare_apis --------------> canonical evidence fields

これにより、公開 MCP インターフェース内で、独立した推奨、ランキング、または根拠のシステムを別途保守する必要がなくなります。

正規のホスト型の推奨、ランキング、検証、根拠処理システムの実装は独自のものであり、このリポジトリには含まれていません。

公開インターフェースの詳細については、docs/ARCHITECTURE.md を参照してください。

リポジトリの構成

src/
  worker.js               Publicly inspectable MCP interface implementation

examples/
  requests.md             Example tool calls and expected semantics

docs/
  ARCHITECTURE.md         Public data flow, grounding and failure behavior
  DATA_MODEL.md           Important catalog fields and evidence semantics

CHANGELOG.md               Release history
CONTRIBUTING.md            Contribution and correction workflow
PROPRIETARY_NOTICE.md      Repository rights and proprietary-service boundary

ステータス

ホスト型 RealWorldAPIs サービスは、この公開リポジトリとは独立して進化します。

現在の本番環境での動作については、稼働中の MCP エンドポイントと正規のウェブサイトエンドポイントを使用してください。サードパーティのディレクトリやこのリポジトリには、本番環境へのデプロイ後、一時的に古いツール数、説明、実装の詳細、またはスキーマが表示される場合があります。

貢献

現在のプロバイダーのドキュメントで裏付けられた公開 API メタデータの修正を歓迎します。根拠となる URL を記載し、変更すべき正確なフィールドを示してください。

公開リポジトリへの貢献によって、RealWorldAPIs 独自のランキング、検証、最適化、ベンチマーク、または調査システムへのアクセス権が付与されたり、それらの公開が意味されたりすることはありません。

CONTRIBUTING.md を参照してください。

権利とライセンス

このリポジトリはソースを公開していますが、オープンソースライセンスのもとでは公開されていません。

このリポジトリによって、MIT、Apache、BSD、GPL、その他のオープンソースライセンスが付与されることはありません。

ホスト型 RealWorldAPIs サービスの利用権は、リポジトリのソースコードに関する権利とは別個のものです。公開されているプロトコルの説明、スキーマ、事実に基づく出力は、適用される規約および法律で認められる範囲で相互運用のために利用できますが、ホスト型 RealWorldAPIs の独自システムはこのリポジトリを通じてライセンスされるものではありません。

PROPRIETARY_NOTICE.md を参照してください。

Copyright © 2026 RealWorldAPIs. All rights reserved.