Server definition
- Hash
- sha256:5416fe7a679cc490588e277537c918d3baaaabf92c116410a2aca4f8d4959f6a
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "Choose tools by intent: find_api_for_task for an open-ended natural-language task; search_apis for API-level filters; search_capabilities for capability-level execution/access/safety filters; verify_requirement for evidence-backed YES/NO/PARTIAL/UNKNOWN adjudication of one API against one requirement; get_api for one full API decision profile; compare_apis for 2–8 known candidates. All tools are read-only. The canonical structured data and Verified/High capability graph are authoritative and Unknown remains Unknown.",
"tools": [
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"apis": {
"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.",
"items": {
"type": "string"
},
"maxItems": 8,
"minItems": 2,
"type": "array"
},
"fields": {
"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": {
"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"
},
"type": "array",
"uniqueItems": true
}
},
"required": [
"apis"
],
"type": "object"
},
"name": "compare_apis",
"outputSchema": {
"additionalProperties": false,
"properties": {
"capability_graph": {
"type": "string"
},
"evidence_policy": {
"type": "string"
},
"fields": {
"items": {
"type": "string"
},
"type": "array"
},
"method": {
"type": "string"
},
"name": {
"type": "string"
},
"records": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"values": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"slug",
"name",
"values"
],
"type": "object"
},
"type": "array"
},
"unresolved": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"name",
"method",
"fields",
"records",
"unresolved",
"evidence_policy"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"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.",
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"requirements": {
"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": {
"auth": {
"description": "Authentication requirement appended as an explicit task requirement. The canonical engine excludes only when the verified API authentication methods contradict it.",
"enum": [
"none",
"api_key",
"oauth",
"client_credentials",
"bearer",
"jwt",
"basic"
],
"type": "string"
},
"capabilities": {
"description": "Desired agent capability dimensions. These are appended as ranking hints, not strict filters.",
"items": {
"enum": [
"observe",
"locate",
"predict",
"plan",
"control",
"act"
],
"type": "string"
},
"type": "array"
},
"categories": {
"description": "Preferred catalog categories, such as Geospatial, Weather or Mobility. These are ranking hints, not strict filters.",
"items": {
"type": "string"
},
"type": "array"
},
"free_tier": {
"description": "Backward-compatible field only. The canonical recommendation engine does not currently hard-filter on free-tier availability.",
"type": "boolean"
},
"mcp": {
"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.",
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"min_readiness": {
"description": "Backward-compatible field only. It does not hard-filter the canonical top five; use search_apis for a strict minimum readiness threshold.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"openapi": {
"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.",
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
}
},
"type": "object"
},
"task": {
"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.",
"maxLength": 1000,
"type": "string"
}
},
"required": [
"task"
],
"type": "object"
},
"name": "find_api_for_task",
"outputSchema": {
"additionalProperties": true,
"properties": {
"ai": {
"additionalProperties": true,
"type": "object"
},
"ai_comparison": {
"additionalProperties": true,
"description": "Best-effort grounded explanation of only the structured_results candidates.",
"type": [
"object",
"null"
]
},
"compatibility_warnings": {
"items": {
"type": "string"
},
"type": "array"
},
"coverage_status": {
"type": "string"
},
"coverage_warnings": {
"items": {
"type": "string"
},
"type": "array"
},
"effective_query": {
"type": "string"
},
"engine_version": {
"type": "string"
},
"grounding_policy": {
"additionalProperties": true,
"type": "object"
},
"method": {
"type": "string"
},
"name": {
"type": "string"
},
"snapshot_date": {
"type": [
"string",
"null"
]
},
"source_endpoints": {
"additionalProperties": true,
"type": "object"
},
"structured_results": {
"description": "Canonical deterministic shortlist. This is the authoritative result set.",
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"task": {
"type": "string"
},
"timing_ms": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"name",
"task",
"structured_results",
"ai",
"grounding_policy"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"identifier": {
"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.",
"maxLength": 200,
"type": "string"
}
},
"required": [
"identifier"
],
"type": "object"
},
"name": "get_api",
"outputSchema": {
"additionalProperties": false,
"properties": {
"capability_graph": {
"type": "string"
},
"evidence_policy": {
"type": "string"
},
"name": {
"type": "string"
},
"record": {
"additionalProperties": true,
"properties": {
"a2a": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"agent_actionable": {
"type": "boolean"
},
"agent_capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"agent_readiness_score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"auth_methods": {
"items": {
"type": "string"
},
"type": "array"
},
"authentication_verified": {
"type": "boolean"
},
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"capability_profile": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"capability_profile_url": {
"type": [
"string",
"null"
]
},
"capability_summary": {
"additionalProperties": true,
"type": [
"object",
"null"
]
},
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"docs_url": {
"type": [
"string",
"null"
]
},
"llms_txt": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"mcp": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"name": {
"type": "string"
},
"openapi": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"provider": {
"type": "string"
},
"public_documentation": {
"type": "boolean"
},
"slug": {
"type": "string"
},
"website": {
"type": [
"string",
"null"
]
},
"x402": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
}
},
"type": "object"
},
"source": {
"type": "string"
}
},
"required": [
"name",
"record",
"source",
"capability_graph",
"evidence_policy"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"a2a": {
"description": "Exact A2A evidence status required for a match.",
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"agent_actionable": {
"description": "When true, require agent_actionable = true. False does not exclude actionable records; omit this field unless you need the positive requirement.",
"type": "boolean"
},
"agent_capabilities": {
"description": "Agent capability dimensions that must all be explicitly present on a record.",
"items": {
"enum": [
"observe",
"locate",
"predict",
"plan",
"control",
"act"
],
"type": "string"
},
"type": "array"
},
"capabilities": {
"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.",
"items": {
"type": "string"
},
"type": "array"
},
"categories": {
"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.",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"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.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"llms_txt": {
"description": "Exact llms.txt evidence status required for a match.",
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"mcp": {
"description": "Exact MCP evidence status required for a match.",
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"min_readiness": {
"description": "Strict minimum agent-readiness score. Records below this score are excluded.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"openapi": {
"description": "Exact OpenAPI evidence status required for a match.",
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"query": {
"description": "Optional case-insensitive text search across API name, provider, category, description, capabilities, agent capabilities and authentication fields.",
"maxLength": 300,
"type": "string"
},
"x402": {
"description": "Exact x402 evidence status required for a match.",
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_apis",
"outputSchema": {
"additionalProperties": false,
"properties": {
"capability_graph": {
"type": "string"
},
"evidence_policy": {
"type": "string"
},
"filters": {
"additionalProperties": true,
"type": "object"
},
"method": {
"type": "string"
},
"name": {
"type": "string"
},
"query": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"properties": {
"a2a": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"agent_actionable": {
"type": "boolean"
},
"agent_capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"agent_readiness_score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"auth_methods": {
"items": {
"type": "string"
},
"type": "array"
},
"authentication_verified": {
"type": "boolean"
},
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"capability_profile": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"capability_profile_url": {
"type": [
"string",
"null"
]
},
"capability_summary": {
"additionalProperties": true,
"type": [
"object",
"null"
]
},
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"docs_url": {
"type": [
"string",
"null"
]
},
"llms_txt": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"mcp": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"name": {
"type": "string"
},
"openapi": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
},
"provider": {
"type": "string"
},
"public_documentation": {
"type": "boolean"
},
"slug": {
"type": "string"
},
"website": {
"type": [
"string",
"null"
]
},
"x402": {
"enum": [
"Yes",
"No",
"Unknown"
],
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"returned": {
"minimum": 0,
"type": "integer"
},
"total_matches": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"name",
"method",
"filters",
"total_matches",
"returned",
"results",
"evidence_policy"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"access_friction": {
"description": "Exact access-friction labels such as Self-service signup, Sales contract or Hardware ecosystem.",
"items": {
"type": "string"
},
"type": "array"
},
"action_types": {
"description": "Exact action types such as Read, Search, Analyze, Route or Control.",
"items": {
"type": "string"
},
"type": "array"
},
"actionability": {
"description": "Exact actionability labels such as Information only, Planning or Physical action.",
"items": {
"type": "string"
},
"type": "array"
},
"agent_setup": {
"description": "Exact agent-setup labels such as Fully self-service or Human setup required.",
"items": {
"type": "string"
},
"type": "array"
},
"api_slugs": {
"description": "Optional API slugs. Multiple values are OR within this filter.",
"items": {
"type": "string"
},
"type": "array"
},
"categories": {
"description": "Exact category labels. Multiple values are OR within this filter.",
"items": {
"type": "string"
},
"type": "array"
},
"hardware_dependency": {
"description": "Exact hardware-dependency labels.",
"items": {
"type": "string"
},
"type": "array"
},
"human_approval": {
"description": "Exact approval labels, for example Required, Not required, Depends on action or Unknown.",
"items": {
"type": "string"
},
"type": "array"
},
"irreversible_high_consequence": {
"description": "When supplied, require the exact irreversible/high-consequence boolean.",
"type": "boolean"
},
"limit": {
"default": 20,
"description": "Maximum capability rows returned. total_matches reports the full match count.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"object": {
"description": "Case-insensitive substring match on the object acted upon, such as smart lock, parcel or charging session.",
"maxLength": 200,
"type": "string"
},
"physical_consequence": {
"description": "When supplied, require the exact physical-consequence boolean.",
"type": "boolean"
},
"primitives": {
"description": "Exact capability primitives such as Observe, Locate, Predict, Plan, Control or Act.",
"items": {
"type": "string"
},
"type": "array"
},
"query": {
"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.",
"maxLength": 300,
"type": "string"
},
"sandbox": {
"description": "Exact sandbox/test-environment labels, including Unknown when desired.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "search_capabilities",
"outputSchema": {
"additionalProperties": false,
"properties": {
"capability_snapshot_date": {
"type": [
"string",
"null"
]
},
"evidence_policy": {
"type": "string"
},
"filters": {
"additionalProperties": true,
"type": "object"
},
"machine_schema_version": {
"type": [
"string",
"null"
]
},
"method": {
"type": "string"
},
"name": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"properties": {
"access_friction": {
"type": "string"
},
"action_type": {
"type": "string"
},
"actionability": {
"type": "string"
},
"agent_setup": {
"type": "string"
},
"api_name": {
"type": "string"
},
"api_record_url": {
"type": "string"
},
"api_slug": {
"type": "string"
},
"category": {
"type": "string"
},
"constraints": {
"items": {
"type": "string"
},
"type": "array"
},
"evidence_url": {
"type": "string"
},
"hardware_dependency": {
"type": "string"
},
"human_approval": {
"type": "string"
},
"irreversible_high_consequence": {
"type": "boolean"
},
"key": {
"type": "string"
},
"name": {
"type": "string"
},
"object": {
"type": "string"
},
"physical_consequence": {
"type": "boolean"
},
"primitive": {
"type": "string"
},
"provider": {
"type": "string"
},
"sandbox": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"returned": {
"minimum": 0,
"type": "integer"
},
"source": {
"type": "string"
},
"total_matches": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"name",
"method",
"filters",
"total_matches",
"returned",
"results",
"source",
"evidence_policy"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api": {
"description": "Exact API slug or API name, for example nuki-web-api or Nuki Web API.",
"maxLength": 200,
"type": "string"
},
"location": {
"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.",
"maxLength": 200,
"type": "string"
},
"requirement": {
"description": "Specific requirement to verify, for example 'remotely unlock a smart lock without human approval'.",
"maxLength": 1000,
"type": "string"
}
},
"required": [
"api",
"requirement"
],
"type": "object"
},
"name": "verify_requirement",
"outputSchema": {
"additionalProperties": true,
"properties": {
"api": {
"additionalProperties": true,
"type": "object"
},
"api_snapshot_date": {
"type": "string"
},
"assertion_backend": {
"additionalProperties": true,
"type": [
"object",
"null"
]
},
"assertion_findings": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"capability_snapshot_date": {
"type": "string"
},
"confidence": {
"type": "string"
},
"consequence": {
"additionalProperties": true,
"type": [
"object",
"null"
]
},
"dimensions": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"evidence": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"evidence_semantics": {
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"location": {
"type": [
"string",
"null"
]
},
"matched_capability": {
"additionalProperties": true,
"type": [
"object",
"null"
]
},
"prerequisites": {
"additionalProperties": true,
"type": [
"object",
"null"
]
},
"reasons": {
"items": {
"type": "string"
},
"type": "array"
},
"requirement": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"verdict": {
"enum": [
"YES",
"NO",
"PARTIAL",
"UNKNOWN"
],
"type": "string"
}
},
"required": [
"schema_version",
"verdict",
"api",
"requirement",
"dimensions",
"reasons",
"confidence",
"evidence_semantics"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5416fe7a679cc490588e277537c918d3baaaabf92c116410a2aca4f8d4959f6a | sha256sum