RealWorldAPIs
by realworldapis.com · remote · no sign-in to list tools · v3.0.1 · published by com.realworldapis
Evidence-first registry of real-world APIs for AI agents, with verified metadata and comparison.
6 tools: 1 change things and 5 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things1Claude Code: ask: see these tools
- Only reads5Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http realworldapis https://mcp.realworldapis.com/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
6 tools
Changes things 1Claude Code: ask
verify_requirementVerify whether one specific API can satisfy one exact requirement using the canonical Verified/High capability graph plus linked assertion evidence.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: Verify API Requirement
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
Only reads 5Claude Code: allow
compare_apisCompare 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 r…No findings
Why it is in this group
- The name "compare_apis" says "compare": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Compare APIs
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
find_api_for_taskFind the best APIs for a natural-language physical-world task.No findings
Why it is in this group
- The name "find_api_for_task" says "find": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Find API for Task
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
get_apiRetrieve one canonical API decision profile when you already know its name or slug.No findings
Why it is in this group
- The name "get_api" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Get API
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_apisSearch the canonical registry when you already know keywords or exact requirements.No findings
Why it is in this group
- The name "search_apis" says "search": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Search APIs
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_capabilitiesSearch the canonical 770-capability Verified/High decision graph directly.No findings
Why it is in this group
- The name "search_capabilities" says "search": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Search Verified Capabilities
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 3.0.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http realworldapis https://mcp.realworldapis.com/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__realworldapis__find_api_for_task",
"mcp__realworldapis__search_apis",
"mcp__realworldapis__search_capabilities",
"mcp__realworldapis__get_api",
"mcp__realworldapis__compare_apis"
],
"ask": [
"mcp__realworldapis__verify_requirement"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as realworldapis. Review it before you use it.