RealWorldAPIs

{'type': 'object', 'required': ['apis'], 'properties': {'apis': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 8, 'minItems': 2, 'description': 'Required list of 2–8 API slugs or names. Exact matches are preferred; unique partial matches are accepted. Unresolved identifiers are reported separately, and the call fails if fewer than two records resolve.'}, 'fields': {'type': 'array', 'items': {'enum': ['provider', 'category', 'description', 'capabilities', 'agent_capabilities', 'auth_methods', 'openapi', 'mcp', 'a2a', 'x402', 'llms_txt', 'agent_readiness_score', 'public_documentation', 'authentication_verified', 'agent_actionable', 'website', 'docs_url', 'verified_capability_count', 'information_only_count', 'physical_consequence_count', 'irreversible_high_consequence_count', 'approval_relevant_count', 'capability_profile_url'], 'type': 'string'}, 'description': 'Optional fields to compare. The default includes core catalog fields plus verified capability count, physical-consequence count, approval-relevant count, irreversible/high-consequence count and the decision-profile URL.', 'uniqueItems': True}}, 'additionalProperties': False}

{'type': 'object', 'required': ['name', 'method', 'fields', 'records', 'unresolved', 'evidence_policy'], 'properties': {'name': {'type': 'string'}, 'fields': {'type': 'array', 'items': {'type': 'string'}}, 'method': {'type': 'string'}, 'records': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'values'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'values': {'type': 'object', 'additionalProperties': True}}, 'additionalProperties': False}}, 'unresolved': {'type': 'array', 'items': {'type': 'string'}}, 'evidence_policy': {'type': 'string'}, 'capability_graph': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['task'], 'properties': {'task': {'type': 'string', 'maxLength': 1000, 'description': "Required natural-language goal or workflow, for example 'connect to a car and predict weather on the route'. Describe the desired outcome rather than naming a specific API."}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 5, 'minimum': 1, 'description': 'Backward-compatible parameter. The canonical browser-parity workflow always produces five structured candidates before the AI comparison, even when another value is supplied.'}, 'requirements': {'type': 'object', 'properties': {'mcp': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string', 'description': "When set to Yes, becomes an explicit 'Must support MCP' requirement. Verified No excludes; Unknown remains eligible with an uncertainty. Use search_apis for exact status filtering."}, 'auth': {'enum': ['none', 'api_key', 'oauth', 'client_credentials', 'bearer', 'jwt', 'basic'], 'type': 'string', 'description': 'Authentication requirement appended as an explicit task requirement. The canonical engine excludes only when the verified API authentication methods contradict it.'}, 'openapi': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string', 'description': 'When set to Yes, becomes an explicit OpenAPI requirement. Verified No excludes; Unknown remains eligible with an uncertainty. Use search_apis for exact status filtering.'}, 'free_tier': {'type': 'boolean', 'description': 'Backward-compatible field only. The canonical recommendation engine does not currently hard-filter on free-tier availability.'}, 'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Preferred catalog categories, such as Geospatial, Weather or Mobility. These are ranking hints, not strict filters.'}, 'capabilities': {'type': 'array', 'items': {'enum': ['observe', 'locate', 'predict', 'plan', 'control', 'act'], 'type': 'string'}, 'description': 'Desired agent capability dimensions. These are appended as ranking hints, not strict filters.'}, 'min_readiness': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Backward-compatible field only. It does not hard-filter the canonical top five; use search_apis for a strict minimum readiness threshold.'}}, 'description': 'Optional task requirements appended before canonical ranking. categories and capabilities shape task intent. mcp=Yes, openapi=Yes and auth are expressed as hard task requirements and are evaluated against verified evidence; Unknown does not count as a confirmed contradiction and remains eligible with an uncertainty. free_tier and min_readiness are accepted for backward compatibility but are not hard filters.', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['name', 'task', 'structured_results', 'ai', 'grounding_policy'], 'properties': {'ai': {'type': 'object', 'additionalProperties': True}, 'name': {'type': 'string'}, 'task': {'type': 'string'}, 'method': {'type': 'string'}, 'timing_ms': {'type': 'object', 'additionalProperties': True}, 'ai_comparison': {'type': ['object', 'null'], 'description': 'Best-effort grounded explanation of only the structured_results candidates.', 'additionalProperties': True}, 'snapshot_date': {'type': ['string', 'null']}, 'engine_version': {'type': 'string'}, 'coverage_status': {'type': 'string'}, 'effective_query': {'type': 'string'}, 'grounding_policy': {'type': 'object', 'additionalProperties': True}, 'source_endpoints': {'type': 'object', 'additionalProperties': True}, 'coverage_warnings': {'type': 'array', 'items': {'type': 'string'}}, 'structured_results': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Canonical deterministic shortlist. This is the authoritative result set.'}, 'compatibility_warnings': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}

{'type': 'object', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'maxLength': 200, 'description': 'Required API slug or API name. Exact matches are preferred; a unique case-insensitive partial slug/name match is accepted. If it is ambiguous or missing, use search_apis to find the exact identifier.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['name', 'record', 'source', 'capability_graph', 'evidence_policy'], 'properties': {'name': {'type': 'string'}, 'record': {'type': 'object', 'properties': {'a2a': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'mcp': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'x402': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'openapi': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'website': {'type': ['string', 'null']}, 'category': {'type': 'string'}, 'docs_url': {'type': ['string', 'null']}, 'llms_txt': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'provider': {'type': 'string'}, 'description': {'type': 'string'}, 'auth_methods': {'type': 'array', 'items': {'type': 'string'}}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}, 'agent_actionable': {'type': 'boolean'}, 'agent_capabilities': {'type': 'array', 'items': {'type': 'string'}}, 'capability_profile': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'capability_summary': {'type': ['object', 'null'], 'additionalProperties': True}, 'public_documentation': {'type': 'boolean'}, 'agent_readiness_score': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'capability_profile_url': {'type': ['string', 'null']}, 'authentication_verified': {'type': 'boolean'}}, 'additionalProperties': True}, 'source': {'type': 'string'}, 'evidence_policy': {'type': 'string'}, 'capability_graph': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'a2a': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string', 'description': 'Exact A2A evidence status required for a match.'}, 'mcp': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string', 'description': 'Exact MCP evidence status required for a match.'}, 'x402': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string', 'description': 'Exact x402 evidence status required for a match.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 20, 'minimum': 1, 'description': 'Maximum number of matching records returned. Results are sorted by readiness descending then API name. total_matches still reports the full count. No pagination is currently exposed.'}, 'query': {'type': 'string', 'maxLength': 300, 'description': 'Optional case-insensitive text search across API name, provider, category, description, capabilities, agent capabilities and authentication fields.'}, 'openapi': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string', 'description': 'Exact OpenAPI evidence status required for a match.'}, 'llms_txt': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string', 'description': 'Exact llms.txt evidence status required for a match.'}, 'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact category names. Supplying multiple category values allows a record to match any listed category; this category condition still combines with every other supplied filter group using AND logic.'}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}, 'description': "Capability terms that must all be present in the record's verified capabilities. Matching is case-insensitive and allows a capability string to contain the supplied term."}, 'min_readiness': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Strict minimum agent-readiness score. Records below this score are excluded.'}, 'agent_actionable': {'type': 'boolean', 'description': 'When true, require agent_actionable = true. False does not exclude actionable records; omit this field unless you need the positive requirement.'}, 'agent_capabilities': {'type': 'array', 'items': {'enum': ['observe', 'locate', 'predict', 'plan', 'control', 'act'], 'type': 'string'}, 'description': 'Agent capability dimensions that must all be explicitly present on a record.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['name', 'method', 'filters', 'total_matches', 'returned', 'results', 'evidence_policy'], 'properties': {'name': {'type': 'string'}, 'query': {'type': 'string'}, 'method': {'type': 'string'}, 'filters': {'type': 'object', 'additionalProperties': True}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'a2a': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'mcp': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'x402': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'openapi': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'website': {'type': ['string', 'null']}, 'category': {'type': 'string'}, 'docs_url': {'type': ['string', 'null']}, 'llms_txt': {'enum': ['Yes', 'No', 'Unknown'], 'type': 'string'}, 'provider': {'type': 'string'}, 'description': {'type': 'string'}, 'auth_methods': {'type': 'array', 'items': {'type': 'string'}}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}, 'agent_actionable': {'type': 'boolean'}, 'agent_capabilities': {'type': 'array', 'items': {'type': 'string'}}, 'capability_profile': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'capability_summary': {'type': ['object', 'null'], 'additionalProperties': True}, 'public_documentation': {'type': 'boolean'}, 'agent_readiness_score': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'capability_profile_url': {'type': ['string', 'null']}, 'authentication_verified': {'type': 'boolean'}}, 'additionalProperties': True}}, 'returned': {'type': 'integer', 'minimum': 0}, 'total_matches': {'type': 'integer', 'minimum': 0}, 'evidence_policy': {'type': 'string'}, 'capability_graph': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum capability rows returned. total_matches reports the full match count.'}, 'query': {'type': 'string', 'maxLength': 300, 'description': 'Optional case-insensitive text search across API/provider/category, capability key/name, primitive/action type, object, execution fields and constraints. Search terms may match across different capability fields; all supplied terms must be present somewhere in the capability record.'}, 'object': {'type': 'string', 'maxLength': 200, 'description': 'Case-insensitive substring match on the object acted upon, such as smart lock, parcel or charging session.'}, 'sandbox': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact sandbox/test-environment labels, including Unknown when desired.'}, 'api_slugs': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional API slugs. Multiple values are OR within this filter.'}, 'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact category labels. Multiple values are OR within this filter.'}, 'primitives': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact capability primitives such as Observe, Locate, Predict, Plan, Control or Act.'}, 'agent_setup': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact agent-setup labels such as Fully self-service or Human setup required.'}, 'action_types': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact action types such as Read, Search, Analyze, Route or Control.'}, 'actionability': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact actionability labels such as Information only, Planning or Physical action.'}, 'human_approval': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact approval labels, for example Required, Not required, Depends on action or Unknown.'}, 'access_friction': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact access-friction labels such as Self-service signup, Sales contract or Hardware ecosystem.'}, 'hardware_dependency': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact hardware-dependency labels.'}, 'physical_consequence': {'type': 'boolean', 'description': 'When supplied, require the exact physical-consequence boolean.'}, 'irreversible_high_consequence': {'type': 'boolean', 'description': 'When supplied, require the exact irreversible/high-consequence boolean.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['name', 'method', 'filters', 'total_matches', 'returned', 'results', 'source', 'evidence_policy'], 'properties': {'name': {'type': 'string'}, 'method': {'type': 'string'}, 'source': {'type': 'string'}, 'filters': {'type': 'object', 'additionalProperties': True}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'object': {'type': 'string'}, 'sandbox': {'type': 'string'}, 'api_name': {'type': 'string'}, 'api_slug': {'type': 'string'}, 'category': {'type': 'string'}, 'provider': {'type': 'string'}, 'primitive': {'type': 'string'}, 'action_type': {'type': 'string'}, 'agent_setup': {'type': 'string'}, 'constraints': {'type': 'array', 'items': {'type': 'string'}}, 'evidence_url': {'type': 'string'}, 'actionability': {'type': 'string'}, 'api_record_url': {'type': 'string'}, 'human_approval': {'type': 'string'}, 'access_friction': {'type': 'string'}, 'hardware_dependency': {'type': 'string'}, 'physical_consequence': {'type': 'boolean'}, 'irreversible_high_consequence': {'type': 'boolean'}}, 'additionalProperties': True}}, 'returned': {'type': 'integer', 'minimum': 0}, 'total_matches': {'type': 'integer', 'minimum': 0}, 'evidence_policy': {'type': 'string'}, 'machine_schema_version': {'type': ['string', 'null']}, 'capability_snapshot_date': {'type': ['string', 'null']}}, 'additionalProperties': False}

{'type': 'object', 'required': ['api', 'requirement'], 'properties': {'api': {'type': 'string', 'maxLength': 200, 'description': 'Exact API slug or API name, for example nuki-web-api or Nuki Web API.'}, 'location': {'type': 'string', 'maxLength': 200, 'description': 'Optional geographic coverage requirement, for example Sweden. Coverage is returned as Unknown/Partial when the normalized capability graph does not contain enough location evidence.'}, 'requirement': {'type': 'string', 'maxLength': 1000, 'description': "Specific requirement to verify, for example 'remotely unlock a smart lock without human approval'."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['schema_version', 'verdict', 'api', 'requirement', 'dimensions', 'reasons', 'confidence', 'evidence_semantics'], 'properties': {'api': {'type': 'object', 'additionalProperties': True}, 'reasons': {'type': 'array', 'items': {'type': 'string'}}, 'verdict': {'enum': ['YES', 'NO', 'PARTIAL', 'UNKNOWN'], 'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'location': {'type': ['string', 'null']}, 'confidence': {'type': 'string'}, 'dimensions': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'consequence': {'type': ['object', 'null'], 'additionalProperties': True}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'requirement': {'type': 'string'}, 'prerequisites': {'type': ['object', 'null'], 'additionalProperties': True}, 'schema_version': {'type': 'string'}, 'api_snapshot_date': {'type': 'string'}, 'assertion_backend': {'type': ['object', 'null'], 'additionalProperties': True}, 'assertion_findings': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'evidence_semantics': {'type': 'string'}, 'matched_capability': {'type': ['object', 'null'], 'additionalProperties': True}, 'capability_snapshot_date': {'type': 'string'}}, 'additionalProperties': True}