RealWorldAPIs
Evidence-first registry of real-world APIs for AI agents, with verified metadata and comparison.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~4,350토큰 (도구 정의)
~8.1 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 3.40%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"realworldapis": {
"url": "https://realworldapis-api.realworldapis.workers.dev/mcp"
}
}
}원격 엔드포인트
https://realworldapis-api.realworldapis.workers.dev/mcpstreamable-httphttps://mcp.realworldapis.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (6)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢find_api_for_task(task, requirements, limit)
Find the best APIs for a natural-language physical-world task. Use this for open-ended task or outcome-based recommendations; use search_apis when you already know exact filters, get_api for one known API, or compare_apis for known candidates. Returns an authoritative canonical structured_results shortlist plus a best-effort AI comparison restricted to that shortlist. The canonical engine now applies Verified/High capability evidence before ranking: explicit hard requirements expressed with terms such as must, required, no or without can exclude a candidate only when verified evidence contradicts them. Unknown evidence remains eligible and is surfaced as uncertainty. requirements.mcp, openapi and auth are translated into explicit requirements; categories and capabilities remain task-shaping hints. free_tier and min_readiness are accepted for compatibility but are not hard filters.
입력 스키마
{
"type": "object",
"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."
},
"requirements": {
"type": "object",
"additionalProperties": false,
"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.",
"properties": {
"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": {
"type": "string",
"enum": [
"observe",
"locate",
"predict",
"plan",
"control",
"act"
]
},
"description": "Desired agent capability dimensions. These are appended as ranking hints, not strict filters."
},
"mcp": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
],
"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."
},
"openapi": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
],
"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."
},
"auth": {
"type": "string",
"enum": [
"none",
"api_key",
"oauth",
"client_credentials",
"bearer",
"jwt",
"basic"
],
"description": "Authentication requirement appended as an explicit task requirement. The canonical engine excludes only when the verified API authentication methods contradict it."
},
"min_readiness": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Backward-compatible field only. It does not hard-filter the canonical top five; use search_apis for a strict minimum readiness threshold."
}
}
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"default": 5,
"description": "Backward-compatible parameter. The canonical browser-parity workflow always produces five structured candidates before the AI comparison, even when another value is supplied."
}
},
"required": [
"task"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"engine_version": {
"type": "string"
},
"method": {
"type": "string"
},
"task": {
"type": "string"
},
"effective_query": {
"type": "string"
},
"snapshot_date": {
"type": [
"string",
"null"
]
},
"coverage_status": {
"type": "string"
},
"coverage_warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"structured_results": {
"type": "array",
"description": "Canonical deterministic shortlist. This is the authoritative result set.",
"items": {
"type": "object",
"additionalProperties": true
}
},
"ai_comparison": {
"type": [
"object",
"null"
],
"additionalProperties": true,
"description": "Best-effort grounded explanation of only the structured_results candidates."
},
"ai": {
"type": "object",
"additionalProperties": true
},
"compatibility_warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"source_endpoints": {
"type": "object",
"additionalProperties": true
},
"grounding_policy": {
"type": "object",
"additionalProperties": true
},
"timing_ms": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"name",
"task",
"structured_results",
"ai",
"grounding_policy"
],
"additionalProperties": true
}🟢search_apis(query, categories, capabilities, agent_capabilities, openapi, ...)
Search the canonical registry when you already know keywords or exact requirements. All supplied filter groups combine with AND logic; array capability filters require every supplied value, and protocol fields match the exact Yes/No/Unknown status, so Unknown never satisfies Yes. Results include each API's capability_summary and direct decision-profile URL. Results are sorted by agent_readiness_score descending and then API name, with 1–20 results returned (default 10). Use search_capabilities when you need capability-level filters such as approval, physical consequence, sandbox or access friction.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 300,
"description": "Optional case-insensitive text search across API name, provider, category, description, capabilities, agent capabilities and authentication fields."
},
"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."
},
"agent_capabilities": {
"type": "array",
"items": {
"type": "string",
"enum": [
"observe",
"locate",
"predict",
"plan",
"control",
"act"
]
},
"description": "Agent capability dimensions that must all be explicitly present on a record."
},
"openapi": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
],
"description": "Exact OpenAPI evidence status required for a match."
},
"mcp": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
],
"description": "Exact MCP evidence status required for a match."
},
"a2a": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
],
"description": "Exact A2A evidence status required for a match."
},
"x402": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
],
"description": "Exact x402 evidence status required for a match."
},
"llms_txt": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
],
"description": "Exact llms.txt evidence status required for a match."
},
"min_readiness": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"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."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10,
"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."
}
},
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"method": {
"type": "string"
},
"query": {
"type": "string"
},
"filters": {
"type": "object",
"additionalProperties": true
},
"total_matches": {
"type": "integer",
"minimum": 0
},
"returned": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"provider": {
"type": "string"
},
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"agent_capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"auth_methods": {
"type": "array",
"items": {
"type": "string"
}
},
"openapi": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"mcp": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"a2a": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"x402": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"llms_txt": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"agent_readiness_score": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"public_documentation": {
"type": "boolean"
},
"authentication_verified": {
"type": "boolean"
},
"agent_actionable": {
"type": "boolean"
},
"website": {
"type": [
"string",
"null"
]
},
"docs_url": {
"type": [
"string",
"null"
]
},
"capability_profile_url": {
"type": [
"string",
"null"
]
},
"capability_summary": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"capability_profile": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
}
}
},
"capability_graph": {
"type": "string"
},
"evidence_policy": {
"type": "string"
}
},
"required": [
"name",
"method",
"filters",
"total_matches",
"returned",
"results",
"evidence_policy"
],
"additionalProperties": false
}🟢search_capabilities(query, api_slugs, categories, primitives, action_types, ...)
Search the canonical 770-capability Verified/High decision graph directly. Use this when the question is about what an agent can actually do and under what execution conditions: task/capability text, API, category, action type, acted-on object, human approval, physical consequence, irreversibility, sandbox, hardware dependency, access friction or setup. All supplied filter groups combine with AND logic; multiple values inside one array filter are alternatives (OR). Unknown remains Unknown and may be filtered explicitly by passing the literal value Unknown.
입력 스키마
{
"type": "object",
"properties": {
"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."
},
"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."
},
"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."
},
"object": {
"type": "string",
"maxLength": 200,
"description": "Case-insensitive substring match on the object acted upon, such as smart lock, parcel or charging session."
},
"human_approval": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact approval labels, for example Required, Not required, Depends on action or Unknown."
},
"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."
},
"sandbox": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact sandbox/test-environment labels, including Unknown when desired."
},
"hardware_dependency": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact hardware-dependency labels."
},
"access_friction": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact access-friction labels such as Self-service signup, Sales contract or Hardware ecosystem."
},
"agent_setup": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact agent-setup labels such as Fully self-service or Human setup required."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Maximum capability rows returned. total_matches reports the full match count."
}
},
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"method": {
"type": "string"
},
"machine_schema_version": {
"type": [
"string",
"null"
]
},
"capability_snapshot_date": {
"type": [
"string",
"null"
]
},
"filters": {
"type": "object",
"additionalProperties": true
},
"total_matches": {
"type": "integer",
"minimum": 0
},
"returned": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"api_slug": {
"type": "string"
},
"api_name": {
"type": "string"
},
"provider": {
"type": "string"
},
"category": {
"type": "string"
},
"api_record_url": {
"type": "string"
},
"key": {
"type": "string"
},
"name": {
"type": "string"
},
"primitive": {
"type": "string"
},
"actionability": {
"type": "string"
},
"action_type": {
"type": "string"
},
"object": {
"type": "string"
},
"sandbox": {
"type": "string"
},
"hardware_dependency": {
"type": "string"
},
"access_friction": {
"type": "string"
},
"agent_setup": {
"type": "string"
},
"human_approval": {
"type": "string"
},
"irreversible_high_consequence": {
"type": "boolean"
},
"physical_consequence": {
"type": "boolean"
},
"constraints": {
"type": "array",
"items": {
"type": "string"
}
},
"evidence_url": {
"type": "string"
}
}
}
},
"source": {
"type": "string"
},
"evidence_policy": {
"type": "string"
}
},
"required": [
"name",
"method",
"filters",
"total_matches",
"returned",
"results",
"source",
"evidence_policy"
],
"additionalProperties": false
}🟢verify_requirement(api, requirement, location)
Verify whether one specific API can satisfy one exact requirement using the canonical Verified/High capability graph plus linked assertion evidence. Returns YES, NO, PARTIAL or UNKNOWN with matched capability, access/setup prerequisites, approval, safety, reversibility, reliability, coverage and other requested dimensions; direct provider facts remain distinct from inferred policy assertions. Unknown remains Unknown.
입력 스키마
{
"type": "object",
"properties": {
"api": {
"type": "string",
"maxLength": 200,
"description": "Exact API slug or API name, for example nuki-web-api or Nuki Web API."
},
"requirement": {
"type": "string",
"maxLength": 1000,
"description": "Specific requirement to verify, for example 'remotely unlock a smart lock without human approval'."
},
"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."
}
},
"required": [
"api",
"requirement"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"verdict": {
"type": "string",
"enum": [
"YES",
"NO",
"PARTIAL",
"UNKNOWN"
]
},
"api": {
"type": "object",
"additionalProperties": true
},
"requirement": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"matched_capability": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"dimensions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"prerequisites": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"consequence": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"confidence": {
"type": "string"
},
"assertion_backend": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"assertion_findings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"capability_snapshot_date": {
"type": "string"
},
"api_snapshot_date": {
"type": "string"
},
"evidence_semantics": {
"type": "string"
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"schema_version",
"verdict",
"api",
"requirement",
"dimensions",
"reasons",
"confidence",
"evidence_semantics"
],
"additionalProperties": true
}🟢get_api(identifier)
Retrieve one canonical API decision profile when you already know its name or slug. The response includes the full Verified/High capability profile with execution, access, approval, reversibility, physical-consequence and evidence fields. Exact slug or exact API name is preferred; a partial identifier is accepted only when it uniquely resolves to one record.
입력 스키마
{
"type": "object",
"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."
}
},
"required": [
"identifier"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"record": {
"type": "object",
"additionalProperties": true,
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"provider": {
"type": "string"
},
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"agent_capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"auth_methods": {
"type": "array",
"items": {
"type": "string"
}
},
"openapi": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"mcp": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"a2a": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"x402": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"llms_txt": {
"type": "string",
"enum": [
"Yes",
"No",
"Unknown"
]
},
"agent_readiness_score": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"public_documentation": {
"type": "boolean"
},
"authentication_verified": {
"type": "boolean"
},
"agent_actionable": {
"type": "boolean"
},
"website": {
"type": [
"string",
"null"
]
},
"docs_url": {
"type": [
"string",
"null"
]
},
"capability_profile_url": {
"type": [
"string",
"null"
]
},
"capability_summary": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"capability_profile": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
}
},
"source": {
"type": "string"
},
"capability_graph": {
"type": "string"
},
"evidence_policy": {
"type": "string"
}
},
"required": [
"name",
"record",
"source",
"capability_graph",
"evidence_policy"
],
"additionalProperties": false
}🟢compare_apis(apis, fields)
Compare 2–8 already-known APIs side by side using canonical catalog fields plus capability-graph summary fields such as verified capability count, physical consequences, approval relevance and irreversibility. Use get_api for the full decision profile of one API and search_capabilities for capability-level filtering. No missing value is inferred and Unknown remains Unknown.
입력 스키마
{
"type": "object",
"properties": {
"apis": {
"type": "array",
"minItems": 2,
"maxItems": 8,
"items": {
"type": "string"
},
"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",
"uniqueItems": true,
"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.",
"items": {
"type": "string",
"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"
]
}
}
},
"required": [
"apis"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"method": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"records": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"slug",
"name",
"values"
],
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"values": {
"type": "object",
"additionalProperties": true
}
}
}
},
"unresolved": {
"type": "array",
"items": {
"type": "string"
}
},
"capability_graph": {
"type": "string"
},
"evidence_policy": {
"type": "string"
}
},
"required": [
"name",
"method",
"fields",
"records",
"unresolved",
"evidence_policy"
],
"additionalProperties": false
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 6개
검증됨버전이 기록되지 않음도구 6개
검증됨버전이 기록되지 않음도구 4개
검증됨버전이 기록되지 않음도구 4개
검증됨버전이 기록되지 않음도구 1개