# RealWorldAPIs

> RealWorldAPIs is an evidence-first API discovery and decision layer for AI agents connecting to the physical world.
> RWAPIS matches tasks to verified API capabilities and checks access, approval, safety, reversibility and execution constraints before ranking.
> A real-world API connects software or AI agents to data, devices, infrastructure or services representing the physical world — including weather, maps, mobility, logistics, IoT, energy and robotics.

## Important semantics
- Unknown protocol support is not confirmed support.
- /api/recommend is deterministic and evidence-based.
- /api/ai-recommend only compares the deterministic verified shortlist; it may not introduce outside APIs.
- Verify provider capabilities against current provider documentation before implementation.

## Primary pages
- https://realworldapis.com/
- https://realworldapis.com/categories
- https://realworldapis.com/categories/geospatial
- https://realworldapis.com/categories/weather
- https://realworldapis.com/categories/mobility
- https://realworldapis.com/categories/robotics
- https://realworldapis.com/categories/satellite
- https://realworldapis.com/categories/iot
- https://realworldapis.com/categories/energy
- https://realworldapis.com/categories/logistics
- https://realworldapis.com/for-agents
- https://realworldapis.com/mcp
- https://realworldapis.com/machine-readable
- https://realworldapis.com/research/state-of-agent-ready-apis-2026

## Machine endpoints
- Catalog: https://realworldapis.com/api/catalog.json
- Verified capability graph: https://realworldapis.com/api/capabilities.json
- Requirement verification: https://realworldapis.com/api/verify-requirement
- Per-API decision profile: https://realworldapis.com/api/apis/{slug}.json
- Full dataset: https://realworldapis.com/real-world-apis.json
- Full LLM catalog: https://realworldapis.com/llms-full.txt
- Categories: https://realworldapis.com/categories.json
- OpenAPI: https://realworldapis.com/openapi.json
- Research JSON: https://realworldapis.com/research/state-of-agent-ready-apis-2026.json
- Structured recommendations: https://realworldapis.com/api/recommend?q=YOUR_TASK
- AI comparison: https://realworldapis.com/api/ai-recommend?q=YOUR_TASK
- ARD: https://realworldapis.com/.well-known/ard.json
- MCP metadata: https://realworldapis.com/mcp.json
- MCP tool flow: deterministic diversified top 5, then constrained AI comparison; structured results remain the source of truth
- Live MCP (Streamable HTTP): https://mcp.realworldapis.com/mcp
- MCP tools: find_api_for_task, search_apis, search_capabilities, verify_requirement, get_api, compare_apis
- Health: https://realworldapis.com/health

## Representative tasks
- I need to locate a vehicle, check local weather, and route a technician there.
- Find APIs for satellite imagery, change monitoring and geospatial search.
- My agent needs live vessel positions and port-call data.
- Find APIs for robot fleet operations and device telemetry.
- I need parcel rates, label creation and shipment tracking.