Santismm Knowledge — Harness Engineering, Agentic AI & Governance is an MCP server published by com.santismm, hosted at santismm.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 41 tools, including get_author_profile, get_overview, search_all, list_knowledge, get_knowledge.
Query AI knowledge, essays, Labs, benchmarks, Physical AI robotics, Homeric data and claims.
710 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the author's professional profile as structured facts: name and the other forms it takes, current role with its start date, previous organisations, the frameworks he is the author of with their canonical URLs, how to cite this work, the licence, and the date these facts were last verified. Use this to attribute or cite anything this server returns. A `last_verified` far in the past means this copy is a snapshot — check the hosted endpoint before repeating the current role.
No parameters.
{
"name": "get_author_profile",
"title": "Who wrote this corpus",
"description": "Get the author's professional profile as structured facts: name and the other forms it takes, current role with its start date, previous organisations, the frameworks he is the author of with their canonical URLs, how to cite this work, the licence, and the date these facts were last verified. Use this to attribute or cite anything this server returns. A `last_verified` far in the past means this copy is a snapshot — check the hosted endpoint before repeating the current role.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"resource_uri",
"name",
"alternate_names",
"current_role",
"previous_roles",
"trained_at",
"canonical_url",
"profiles",
"frameworks",
"how_to_cite",
"license",
"license_spdx",
"license_url",
"last_verified"
],
"properties": {
"name": {
"type": "string"
},
"license": {
"type": "string"
},
"profiles": {
"type": "array",
"items": {
"type": "string"
}
},
"frameworks": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"name",
"url"
],
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Frameworks he authored. The term 'Harness Engineering' itself is not claimed here."
},
"trained_at": {
"type": "array",
"items": {
"type": "string"
}
},
"how_to_cite": {
"type": "string"
},
"license_url": {
"type": "string"
},
"current_role": {
"type": "object",
"required": [
"title",
"organization",
"since"
],
"properties": {
"since": {
"type": "string",
"description": "ISO date the role started."
},
"title": {
"type": "string"
},
"organization": {
"type": "string"
}
},
"additionalProperties": false
},
"license_spdx": {
"type": "string"
},
"resource_uri": {
"type": "string",
"description": "Read this same document with resources/read."
},
"canonical_url": {
"type": "string",
"description": "The entity page. Cite this for the person."
},
"last_verified": {
"type": "string",
"description": "ISO date these facts were last checked. Compare it against today."
},
"previous_roles": {
"type": "array",
"items": {
"type": "object",
"required": [
"organization"
],
"properties": {
"note": {
"type": "string"
},
"regions": {
"type": "array",
"items": {
"type": "string"
}
},
"organization": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Past, and only past. Never the current role."
},
"alternate_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Other forms of the same name — one entity, not several."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the complete MCP map — start here. Returns the five-domain core plus the separate Article, Labs, Homeric Atlas, claim-registry, AI-benchmark and Physical AI surfaces, with their tools, identifiers, citation rules, languages, licence and bulk-ingest URLs. Federated surfaces that publish a dataset version report it and their live counts.
No parameters.
{
"name": "get_overview",
"title": "Corpus Overview — Start Here",
"description": "Get the complete MCP map — start here. Returns the five-domain core plus the separate Article, Labs, Homeric Atlas, claim-registry, AI-benchmark and Physical AI surfaces, with their tools, identifiers, citation rules, languages, licence and bulk-ingest URLs. Federated surfaces that publish a dataset version report it and their live counts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"resource_uri",
"source",
"site",
"locales",
"license",
"license_spdx",
"license_url",
"total",
"domains",
"extensions",
"corpus",
"next",
"bulk"
],
"properties": {
"bulk": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"next": {
"type": "string"
},
"site": {
"type": "string"
},
"total": {
"type": "number"
},
"corpus": {
"type": "object",
"required": [
"newest_unit",
"freshness"
],
"properties": {
"freshness": {
"type": "string"
},
"newest_unit": {
"type": [
"string",
"null"
],
"description": "Newest unit date in THIS copy (YYYY-MM-DD)."
}
},
"description": "Whether this copy is current. Compare against the hosted endpoint: a lower total or an older newest_unit means you are holding a snapshot, not that the corpus lacks what you asked for.",
"additionalProperties": false
},
"source": {
"type": "string"
},
"domains": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"count",
"description",
"categories",
"tools",
"lookup",
"url",
"api_url"
],
"properties": {
"url": {
"type": "string"
},
"count": {
"type": "number"
},
"tools": {
"type": "object",
"required": [
"list",
"get"
],
"properties": {
"get": {
"type": "string"
},
"list": {
"type": "string"
}
},
"additionalProperties": false
},
"domain": {
"type": "string"
},
"lookup": {
"type": "string"
},
"api_url": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
}
},
"additionalProperties": false
}
},
"license": {
"type": "string"
},
"locales": {
"type": "array",
"items": {
"type": "string"
}
},
"extensions": {
"type": "array",
"items": {
"type": "object",
"required": [
"surface",
"description",
"tools",
"source",
"lookup",
"citation"
],
"properties": {
"live": {
"enum": [
"ok",
"unavailable"
],
"type": "string",
"description": "Whether the live fields could be read on this call."
},
"tools": {
"type": "array",
"items": {
"type": "string"
}
},
"counts": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
{
"type": "null"
}
],
"description": "Live record counts from the federated host's own index."
},
"lookup": {
"type": "string"
},
"source": {
"type": "string"
},
"surface": {
"type": "string"
},
"citation": {
"type": "string"
},
"description": {
"type": "string"
},
"dataset_version": {
"type": [
"string",
"null"
],
"description": "Version of the federated dataset, read live from its host."
}
},
"additionalProperties": false
}
},
"license_url": {
"type": "string"
},
"license_spdx": {
"type": "string",
"description": "SPDX id — check this, not the prose."
},
"resource_uri": {
"type": "string",
"description": "Read this same document with resources/read."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search the core corpus, first-party essays, executable Labs, epistemic claims, the Homeric Atlas, the AI benchmarks (professions and benchmark catalogue) and Physical AI (robot platforms, documented deployments, deployment guide) in one call. Use this first when a natural-language question might require a calculation, a long-form essay, a claim audit or a model choice rather than only a core knowledge unit. Results name the next tool to call; calculator-shaped questions are routed toward Labs, 'which AI model for…' questions toward the benchmarks, and robotics questions toward Physical AI.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Question or topic, in English, Spanish, Portuguese, French, German, Japanese or Simplified Chinese. |
| locale | string | Language of the returned body. Default: en. |
| surfaces | array | Restrict the search. Omit to search all seven surfaces. |
| content_locales | array | Keep only results whose text is entirely in these languages. `locale` is a presentation preference and still returns substitutions, labelled; this is the hard filter. A result that mixes a language you did not allow is dropped, and so is one that cannot declare its languages. |
| limit_per_surface | integer | Maximum hits from each surface. Default: 5. |
List all knowledge units (concepts on agentic & enterprise AI) with slug, category, title, summary and Evidence-First provenance. Use this to browse the domain; use `search` when you have a question rather than a slug.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_knowledge",
"title": "List Agentic AI Knowledge Units",
"description": "List all knowledge units (concepts on agentic & enterprise AI) with slug, category, title, summary and Evidence-First provenance. Use this to browse the domain; use `search` when you have a question rather than a slug.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one knowledge unit by slug. Returns the full entry, or a single-locale body if locale is given. Use this once `search` or `list_knowledge` has given you a slug.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Knowledge unit slug, e.g. 'harness-engineering'. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_knowledge",
"title": "Get an Agentic AI Knowledge Unit",
"description": "Get one knowledge unit by slug. Returns the full entry, or a single-locale body if locale is given. Use this once `search` or `list_knowledge` has given you a slug.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Knowledge unit slug, e.g. 'harness-engineering'."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain",
"slug",
"category",
"updated",
"version",
"evidence",
"canonical_url",
"api_url",
"references",
"related"
],
"properties": {
"id": {
"type": "string"
},
"body": {},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"locales": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"related": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"fallback": {
"type": "boolean"
},
"featured": {
"type": "boolean"
},
"patterns": {
"type": "array",
"items": {
"type": "string"
}
},
"knowledge": {
"type": "array",
"items": {
"type": "string"
}
},
"frameworks": {
"type": "array",
"items": {
"type": "string"
}
},
"references": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": false
}
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string"
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string"
},
"resolved_locale": {
"type": "string"
},
"requested_locale": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List all Enterprise AI patterns (reusable agentic design patterns) with slug, category, name, summary and provenance. Use this to browse the catalogue; use `search` when you are looking for a pattern that solves a problem.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_patterns",
"title": "List Enterprise AI Patterns",
"description": "List all Enterprise AI patterns (reusable agentic design patterns) with slug, category, name, summary and provenance. Use this to browse the catalogue; use `search` when you are looking for a pattern that solves a problem.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one Enterprise AI pattern by slug (includes problem, solution, KPIs, failure modes, lessons). Use this once `search` or `list_patterns` has given you a slug.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Pattern slug, e.g. 'human-approval-gate'. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_pattern",
"title": "Get an Enterprise AI Pattern",
"description": "Get one Enterprise AI pattern by slug (includes problem, solution, KPIs, failure modes, lessons). Use this once `search` or `list_patterns` has given you a slug.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Pattern slug, e.g. 'human-approval-gate'."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain",
"slug",
"category",
"updated",
"version",
"evidence",
"canonical_url",
"api_url",
"references",
"related"
],
"properties": {
"id": {
"type": "string"
},
"body": {},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"locales": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"related": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"fallback": {
"type": "boolean"
},
"featured": {
"type": "boolean"
},
"patterns": {
"type": "array",
"items": {
"type": "string"
}
},
"knowledge": {
"type": "array",
"items": {
"type": "string"
}
},
"frameworks": {
"type": "array",
"items": {
"type": "string"
}
},
"references": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": false
}
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string"
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string"
},
"resolved_locale": {
"type": "string"
},
"requested_locale": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List all reference architectures (end-to-end enterprise agentic blueprints) with id, slug, category, name, summary and provenance. Use this to browse the blueprints; use `search` when you have a use case rather than a name.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_architectures",
"title": "List Agentic Reference Architectures",
"description": "List all reference architectures (end-to-end enterprise agentic blueprints) with id, slug, category, name, summary and provenance. Use this to browse the blueprints; use `search` when you have a use case rather than a name.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one reference architecture by slug (includes the request flow, reference scenario, KPIs, cost & scaling, and the patterns/knowledge it composes). Use this once `search` or `list_architectures` has given you a slug.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Architecture slug, e.g. 'customer-service-agent'. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_architecture",
"title": "Get an Agentic Reference Architecture",
"description": "Get one reference architecture by slug (includes the request flow, reference scenario, KPIs, cost & scaling, and the patterns/knowledge it composes). Use this once `search` or `list_architectures` has given you a slug.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Architecture slug, e.g. 'customer-service-agent'."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain",
"slug",
"category",
"updated",
"version",
"evidence",
"canonical_url",
"api_url",
"references",
"related"
],
"properties": {
"id": {
"type": "string"
},
"body": {},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"locales": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"related": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"fallback": {
"type": "boolean"
},
"featured": {
"type": "boolean"
},
"patterns": {
"type": "array",
"items": {
"type": "string"
}
},
"knowledge": {
"type": "array",
"items": {
"type": "string"
}
},
"frameworks": {
"type": "array",
"items": {
"type": "string"
}
},
"references": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": false
}
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string"
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string"
},
"resolved_locale": {
"type": "string"
},
"requested_locale": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List all AI governance units (regulations, standards, frameworks, playbooks — EU AI Act, ISO 42001, NIST AI RMF, agentic checklist) with id, slug, category, name and summary. Use this to browse the regulations and standards; use `search` for an obligation or control.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_governance",
"title": "List AI Governance Units",
"description": "List all AI governance units (regulations, standards, frameworks, playbooks — EU AI Act, ISO 42001, NIST AI RMF, agentic checklist) with id, slug, category, name and summary. Use this to browse the regulations and standards; use `search` for an obligation or control.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one AI governance unit by slug (includes scope, key requirements, implementable controls, a checklist and common pitfalls). Use this once `search` or `list_governance` has given you a slug.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Governance unit slug, e.g. 'eu-ai-act'. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_governance",
"title": "Get an AI Governance Unit",
"description": "Get one AI governance unit by slug (includes scope, key requirements, implementable controls, a checklist and common pitfalls). Use this once `search` or `list_governance` has given you a slug.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Governance unit slug, e.g. 'eu-ai-act'."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain",
"slug",
"category",
"updated",
"version",
"evidence",
"canonical_url",
"api_url",
"references",
"related"
],
"properties": {
"id": {
"type": "string"
},
"body": {},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"locales": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"related": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"fallback": {
"type": "boolean"
},
"featured": {
"type": "boolean"
},
"patterns": {
"type": "array",
"items": {
"type": "string"
}
},
"knowledge": {
"type": "array",
"items": {
"type": "string"
}
},
"frameworks": {
"type": "array",
"items": {
"type": "string"
}
},
"references": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": false
}
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string"
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string"
},
"resolved_locale": {
"type": "string"
},
"requested_locale": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the Harness Engineering Handbook chapters (HRN-001…): the canonical long-form corpus on harness engineering — definition, history, taxonomy, principles, memory, observability, evaluation, governance, planning, orchestration, security, case studies, glossary and bibliography. Use this to see the chapter map; use `search` when you have a topic rather than a chapter.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_handbook",
"title": "List Harness Engineering Handbook Chapters",
"description": "List the Harness Engineering Handbook chapters (HRN-001…): the canonical long-form corpus on harness engineering — definition, history, taxonomy, principles, memory, observability, evaluation, governance, planning, orchestration, security, case studies, glossary and bibliography. Use this to see the chapter map; use `search` when you have a topic rather than a chapter.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one Harness Engineering Handbook chapter, by id (e.g. 'HRN-001') or slug. Returns the full Markdown body plus its provenance and related ids. Use this once `search` or `list_handbook` has given you an id.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Chapter id like 'HRN-001', or its slug. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_handbook",
"title": "Get a Harness Engineering Handbook Chapter",
"description": "Get one Harness Engineering Handbook chapter, by id (e.g. 'HRN-001') or slug. Returns the full Markdown body plus its provenance and related ids. Use this once `search` or `list_handbook` has given you an id.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Chapter id like 'HRN-001', or its slug."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"body": {
"type": "string",
"description": "Full Markdown body of the chapter."
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"locales": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"related": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"fallback": {
"type": "boolean",
"description": "True when the body is not in the requested locale."
},
"featured": {
"type": "boolean"
},
"patterns": {
"type": "array",
"items": {
"type": "string"
}
},
"knowledge": {
"type": "array",
"items": {
"type": "string"
}
},
"frameworks": {
"type": "array",
"items": {
"type": "string"
}
},
"references": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": false
}
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string"
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string"
},
"resolved_locale": {
"type": "string",
"description": "The locale actually returned. Chapters are authored in English and translated; where a translation exists this equals the requested locale, and `fallback` says when it does not."
},
"requested_locale": {
"type": "string",
"description": "The locale that was asked for."
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Ranked keyword search across the whole corpus (knowledge, patterns, architectures, governance and the handbook). Matches every language and ignores accents, so query in the user's own words. Each hit carries a relevance score and the fields it matched; follow up with the matching get_* tool for full detail. Use this before any `get_*` tool whenever you have a question rather than an identifier.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results (default 20). |
| query * | string | Keyword or phrase to search for in any supported language. |
| locale | string | Language of the returned body. Default: en. |
| domains | array | Restrict to these domains. Omit to search everything, including the handbook. |
{
"name": "search",
"title": "Search Harness Engineering & Agentic AI",
"description": "Ranked keyword search across the whole corpus (knowledge, patterns, architectures, governance and the handbook). Matches every language and ignores accents, so query in the user's own words. Each hit carries a relevance score and the fields it matched; follow up with the matching get_* tool for full detail. Use this before any `get_*` tool whenever you have a question rather than an identifier.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max results (default 20).",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Keyword or phrase to search for in any supported language."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
},
"domains": {
"type": "array",
"items": {
"enum": [
"knowledge",
"patterns",
"architectures",
"governance",
"handbook"
],
"type": "string"
},
"description": "Restrict to these domains. Omit to search everything, including the handbook."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name",
"score",
"matchedFields",
"matchedTerms"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"score": {
"type": "number",
"description": "Relevance; higher is better."
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"matchedTerms": {
"type": "array",
"items": {
"type": "string"
}
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"matchedFields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Which fields the query hit."
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List every long-form essay published on articles.santismm.com, with language, dates, topics and citable canonical URLs. Use this to browse the essay catalogue; use `search_articles` when you have a topic rather than a slug.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Restrict by language. Articles are currently published in en, es and pt. |
{
"name": "list_articles",
"title": "List first-party essays",
"description": "List every long-form essay published on articles.santismm.com, with language, dates, topics and citable canonical URLs. Use this to browse the essay catalogue; use `search_articles` when you have a topic rather than a slug.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Restrict by language. Articles are currently published in en, es and pt."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"summary",
"language",
"published",
"modified",
"topics",
"canonical_url",
"api_url",
"resource_uri"
],
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"topics": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"language": {
"type": "string"
},
"modified": {
"type": "string"
},
"published": {
"type": "string"
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"translation_key": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get one complete essay by slug, including its clean Markdown-like body, metadata, licence context and canonical URL. Use this after `list_articles` or `search_articles` has returned the slug you need.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Article slug, e.g. 'the-stopwatch-and-the-exam'. |
{
"name": "get_article",
"title": "Get a first-party essay",
"description": "Get one complete essay by slug, including its clean Markdown-like body, metadata, licence context and canonical URL. Use this after `list_articles` or `search_articles` has returned the slug you need.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Article slug, e.g. 'the-stopwatch-and-the-exam'."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug",
"title",
"summary",
"language",
"published",
"modified",
"topics",
"canonical_url",
"api_url",
"resource_uri",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Full Markdown-like article body."
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"topics": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"language": {
"type": "string"
},
"modified": {
"type": "string"
},
"published": {
"type": "string"
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"translation_key": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Ranked, accent-insensitive full-text search over every first-party essay, including titles, summaries, topics and bodies. Use this when you need long-form analysis about a topic; follow with `get_article` for the complete essay.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum results (default 10). |
| query * | string | Keyword or phrase to search for in any supported language. |
| locale | string | Restrict by language. Articles are currently published in en, es and pt. |
{
"name": "search_articles",
"title": "Search first-party essays",
"description": "Ranked, accent-insensitive full-text search over every first-party essay, including titles, summaries, topics and bodies. Use this when you need long-form analysis about a topic; follow with `get_article` for the complete essay.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"description": "Maximum results (default 10).",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Keyword or phrase to search for in any supported language."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Restrict by language. Articles are currently published in en, es and pt."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"summary",
"language",
"published",
"modified",
"topics",
"canonical_url",
"api_url",
"resource_uri",
"score",
"matchedFields",
"matchedTerms"
],
"properties": {
"slug": {
"type": "string"
},
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"topics": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"language": {
"type": "string"
},
"modified": {
"type": "string"
},
"published": {
"type": "string"
},
"matchedTerms": {
"type": "array",
"items": {
"type": "string"
}
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"matchedFields": {
"type": "array",
"items": {
"type": "string"
}
},
"translation_key": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List the professions that have a ranking of frontier AI models built from independent benchmark results (lawyer, accountant, developer, salesperson, translator, engineer…), each marked as a direct or an indirect evaluation, with the model that ranks first today. Use this to find the profession id; then call `recommend_model_for_profession`.
| Parameter | Type | Description |
|---|---|---|
| group | string | Restrict to one family: knowledge, business, creative, tech, technical or care. |
| locale | string | Language of the names. The benchmarks site publishes en and es; other locales fall back to English. |
| evaluation | string | Restrict to direct evaluations (a benchmark reproduces the job) or indirect ones (general tests only). |
{
"name": "list_professions",
"title": "List the professions with an AI model ranking",
"description": "List the professions that have a ranking of frontier AI models built from independent benchmark results (lawyer, accountant, developer, salesperson, translator, engineer…), each marked as a direct or an indirect evaluation, with the model that ranks first today. Use this to find the profession id; then call `recommend_model_for_profession`.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"group": {
"type": "string",
"maxLength": 64,
"description": "Restrict to one family: knowledge, business, creative, tech, technical or care."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the names. The benchmarks site publishes en and es; other locales fall back to English."
},
"evaluation": {
"enum": [
"direct",
"indirect"
],
"type": "string",
"description": "Restrict to direct evaluations (a benchmark reproduces the job) or indirect ones (general tests only)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"group",
"evaluation",
"first",
"unmeasured_tasks",
"not_measured",
"canonical_url",
"dataset_version",
"resource_uri"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"first": {
"type": [
"string",
"null"
]
},
"group": {
"type": "string"
},
"evaluation": {
"enum": [
"direct",
"indirect"
],
"type": "string"
},
"not_measured": {
"type": "string",
"description": "What no benchmark in the catalogue evaluates at all. Applies even when `unmeasured_tasks` is 0."
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"dataset_version": {
"type": "string"
},
"unmeasured_tasks": {
"type": "number",
"description": "How many of its listed TASKS no benchmark measures yet. Zero is complete task coverage, not a complete measurement — `not_measured` is a different axis and applies anyway."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the ranking of frontier AI models for one profession: the best result, the runner-up, the best value and the best open-weights model, the full table with data coverage and price, which tasks each benchmark measures and which tasks no benchmark measures yet. Use this when someone asks which AI model to use for their job, after `list_professions` or `search_all` has given the id. When `evaluation.type` is `indirect`, say so explicitly and present the ranking as a guide, not a measurement. Cite `canonical_url` with `dataset_version`.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Profession id from list_professions (e.g. 'lawyer', 'translator'), or its name in English or Spanish. |
| limit | integer | Rows of the full table to return (default: all). |
| locale | string | Language of names, tasks and caveats. The benchmarks site publishes en and es; other locales fall back to English. |
{
"name": "recommend_model_for_profession",
"title": "Which AI model is best for a profession",
"description": "Get the ranking of frontier AI models for one profession: the best result, the runner-up, the best value and the best open-weights model, the full table with data coverage and price, which tasks each benchmark measures and which tasks no benchmark measures yet. Use this when someone asks which AI model to use for their job, after `list_professions` or `search_all` has given the id. When `evaluation.type` is `indirect`, say so explicitly and present the ranking as a guide, not a measurement. Cite `canonical_url` with `dataset_version`.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Profession id from list_professions (e.g. 'lawyer', 'translator'), or its name in English or Spanish."
},
"limit": {
"type": "integer",
"maximum": 50,
"description": "Rows of the full table to return (default: all).",
"exclusiveMinimum": 0
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of names, tasks and caveats. The benchmarks site publishes en and es; other locales fall back to English."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"name",
"group",
"requested_locale",
"resolved_locale",
"evaluation",
"tasks",
"unmeasured_tasks",
"coverage",
"picks",
"ranking",
"caveat",
"not_measured",
"canonical_url",
"dataset_version",
"radar_version",
"professions_version",
"resource_uri"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"group": {
"type": "string"
},
"picks": {
"type": "object",
"required": [
"first",
"second",
"close_call",
"best_value",
"best_open_weights"
],
"properties": {
"first": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"org",
"score"
],
"properties": {
"id": {
"type": "string"
},
"org": {
"type": "string"
},
"name": {
"type": "string"
},
"score": {
"type": "number"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"second": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"org",
"score"
],
"properties": {
"id": {
"type": "string"
},
"org": {
"type": "string"
},
"name": {
"type": "string"
},
"score": {
"type": "number"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"best_value": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"org",
"score"
],
"properties": {
"id": {
"type": "string"
},
"org": {
"type": "string"
},
"name": {
"type": "string"
},
"score": {
"type": "number"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"close_call": {
"type": "boolean"
},
"best_open_weights": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"org",
"score"
],
"properties": {
"id": {
"type": "string"
},
"org": {
"type": "string"
},
"name": {
"type": "string"
},
"score": {
"type": "number"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"tasks": {
"type": "array",
"items": {
"type": "object",
"required": [
"task",
"measured_by"
],
"properties": {
"task": {
"type": "string"
},
"measured_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"caveat": {
"type": "string"
},
"ranking": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"org",
"score"
],
"properties": {
"id": {
"type": "string"
},
"org": {
"type": "string"
},
"name": {
"type": "string"
},
"score": {
"type": "number"
}
},
"additionalProperties": {}
}
},
"coverage": {
"type": "object",
"required": [
"tasks_listed",
"tasks_measured",
"tasks_unmeasured",
"dimensions_not_measured",
"how_to_present"
],
"properties": {
"tasks_listed": {
"type": "number"
},
"how_to_present": {
"type": "string",
"description": "Follow this when quoting the limits: it says which of the two axes is complete and which is not."
},
"tasks_measured": {
"type": "number"
},
"tasks_unmeasured": {
"type": "number"
},
"dimensions_not_measured": {
"type": "string",
"description": "What no benchmark evaluates at all — independent of task coverage."
}
},
"additionalProperties": false
},
"evaluation": {
"type": "object",
"required": [
"type",
"direct_share",
"how_to_present"
],
"properties": {
"type": {
"enum": [
"direct",
"indirect"
],
"type": "string"
},
"direct_share": {
"type": "number"
},
"how_to_present": {
"type": "string",
"description": "Follow this when quoting the ranking."
}
},
"additionalProperties": false
},
"not_measured": {
"type": "string",
"description": "Dimensions no benchmark in the catalogue evaluates at all. A different axis from `unmeasured_tasks`, which is about this profession's listed tasks; this one applies even when that list is empty."
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"radar_version": {
"type": "string"
},
"dataset_version": {
"type": "string"
},
"resolved_locale": {
"enum": [
"en",
"es"
],
"type": "string"
},
"requested_locale": {
"type": "string"
},
"unmeasured_tasks": {
"type": "array",
"items": {
"type": "string"
},
"description": "The listed tasks with no benchmark behind them. An empty list means every task is covered, not that the ranking measures everything that matters — see `coverage`."
},
"professions_version": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Put two or more frontier models side by side on the benchmark results recorded for them (score, unit, source table and evidence grade per benchmark), optionally with their rows in one profession's ranking. Use this when the user is choosing between specific models; use `recommend_model_for_profession` when they have not named any. No new aggregate is computed. Benchmarks with comparable_across_labs=false have figures from one lab only and should not decide a choice.
| Parameter | Type | Description |
|---|---|---|
| models * | array | Model ids or names, e.g. ['claude-opus-5.5', 'GPT-6 Astra']. |
| profession | string | Optional profession id or name, to include the models' rows in its ranking. |
{
"name": "compare_models",
"title": "Compare AI models on published benchmark results",
"description": "Put two or more frontier models side by side on the benchmark results recorded for them (score, unit, source table and evidence grade per benchmark), optionally with their rows in one profession's ranking. Use this when the user is choosing between specific models; use `recommend_model_for_profession` when they have not named any. No new aggregate is computed. Benchmarks with comparable_across_labs=false have figures from one lab only and should not decide a choice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"models"
],
"properties": {
"models": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 8,
"minItems": 2,
"description": "Model ids or names, e.g. ['claude-opus-5.5', 'GPT-6 Astra']."
},
"profession": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Optional profession id or name, to include the models' rows in its ranking."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"models",
"unknown_models",
"available_models",
"profession",
"benchmarks",
"note",
"dataset_version",
"radar_version",
"canonical_url"
],
"properties": {
"note": {
"type": "string"
},
"models": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"org"
],
"properties": {
"id": {
"type": "string"
},
"org": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"benchmarks": {
"type": "array",
"items": {
"type": "object",
"required": [
"benchmark",
"comparable_across_labs",
"scores"
],
"properties": {
"scores": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"benchmark": {
"type": "string"
},
"comparable_across_labs": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"profession": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"evaluation",
"rows",
"not_ranked"
],
"properties": {
"id": {
"type": "string"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"org",
"score"
],
"properties": {
"id": {
"type": "string"
},
"org": {
"type": "string"
},
"name": {
"type": "string"
},
"score": {
"type": "number"
}
},
"additionalProperties": {}
}
},
"evaluation": {
"enum": [
"direct",
"indirect"
],
"type": "string"
},
"not_ranked": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"canonical_url": {
"type": "string"
},
"radar_version": {
"type": "string"
},
"unknown_models": {
"type": "array",
"items": {
"type": "string"
}
},
"dataset_version": {
"type": "string"
},
"available_models": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List every benchmark in the AI Agent Benchmarks catalogue (agentic benchmarks with SOTA, saturation and headroom) and in the radar's complementary list (vision, long context, factuality, instruction following, language). Use this to find a benchmark slug; then call `get_benchmark`.
| Parameter | Type | Description |
|---|---|---|
| list | string | Restrict to the agentic catalogue or the complementary list. Omit for both. |
{
"name": "list_benchmarks",
"title": "List the AI benchmarks tracked by benchmarks.santismm.com",
"description": "List every benchmark in the AI Agent Benchmarks catalogue (agentic benchmarks with SOTA, saturation and headroom) and in the radar's complementary list (vision, long context, factuality, instruction following, language). Use this to find a benchmark slug; then call `get_benchmark`.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"list": {
"enum": [
"catalog",
"complementary"
],
"type": "string",
"description": "Restrict to the agentic catalogue or the complementary list. Omit for both."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results",
"dataset_version"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"list",
"sota_normalized",
"resource_uri"
],
"properties": {
"list": {
"enum": [
"catalog",
"complementary"
],
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"group": {
"type": "string"
},
"measures": {
"type": "string"
},
"saturation": {
"type": "string"
},
"resource_uri": {
"type": "string"
},
"sota_normalized": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"dataset_version": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get one benchmark by slug or name: what it measures, state of the art, saturation, headroom, human baseline, source and notes, the radar axis it informs, the model scores recorded on it, and which profession rankings use it. Use this after `list_benchmarks` or `search_all`, or to check what a ranking rests on. Cite `canonical_url` with `dataset_version`.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Benchmark slug from list_benchmarks (e.g. 'swe-bench-pro') or its exact name. |
{
"name": "get_benchmark",
"title": "Get one AI benchmark with its SOTA and model scores",
"description": "Get one benchmark by slug or name: what it measures, state of the art, saturation, headroom, human baseline, source and notes, the radar axis it informs, the model scores recorded on it, and which profession rankings use it. Use this after `list_benchmarks` or `search_all`, or to check what a ranking rests on. Cite `canonical_url` with `dataset_version`.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Benchmark slug from list_benchmarks (e.g. 'swe-bench-pro') or its exact name."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug",
"name",
"list",
"radar",
"model_scores",
"comparable_across_labs",
"used_by_professions",
"canonical_url",
"dataset_version",
"citation",
"resource_uri"
],
"properties": {
"list": {
"enum": [
"catalog",
"complementary"
],
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"radar": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"citation": {
"type": "string"
},
"model_scores": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL with dataset_version."
},
"dataset_version": {
"type": "string"
},
"used_by_professions": {
"type": "array",
"items": {
"type": "string"
}
},
"comparable_across_labs": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List every SANTISMM Lab with its inputs, outputs, assumptions, formulas and citation URL. Use this to discover interactive and machine-readable tools; filter by kind when the user specifically asks for a calculator, converter, experiment or educational game.
| Parameter | Type | Description |
|---|---|---|
| kind | string | Restrict results to one Lab kind. Omit to list every Lab. |
{
"name": "list_labs",
"title": "List calculators, converters, experiments and educational Labs",
"description": "List every SANTISMM Lab with its inputs, outputs, assumptions, formulas and citation URL. Use this to discover interactive and machine-readable tools; filter by kind when the user specifically asks for a calculator, converter, experiment or educational game.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"kind": {
"enum": [
"calculator",
"converter",
"experiment",
"educational-game"
],
"type": "string",
"description": "Restrict results to one Lab kind. Omit to list every Lab."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"executable",
"owner_server",
"slug",
"kind",
"label",
"title",
"description",
"inputs",
"outputs",
"assumptions",
"version",
"updated",
"canonical_url",
"api_url",
"resource_uri"
],
"properties": {
"kind": {
"enum": [
"calculator",
"converter",
"experiment",
"educational-game"
],
"type": "string"
},
"slug": {
"type": "string"
},
"label": {
"type": "string"
},
"title": {
"type": "string"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"outputs": {
"type": "array",
"items": {
"type": "string"
}
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"formulas": {
"type": "array",
"items": {
"type": "string"
}
},
"executable": {
"type": "boolean",
"const": true
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"owner_server": {
"type": "string",
"description": "Host that serves and versions this unit."
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"calculation_url": {
"type": "string"
},
"related_content": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"relationship"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"executable",
"owner_server",
"slug",
"category",
"status",
"title",
"canonical_url",
"resource_uri"
],
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string",
"description": "benchmarks, simulators, experiments, games…"
},
"executable": {
"type": "boolean",
"const": false
},
"owner_server": {
"type": "string",
"description": "Host that serves this unit."
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": false
}
]
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get one Lab by slug, including formulas, assumptions, related SANTISMM content and its executable endpoint when one exists. Use this after list_labs or search_all; use the named calculate_* tool rather than reimplementing a published formula.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Lab slug, e.g. 'evaluation-sample-size'. |
{
"name": "get_lab",
"title": "Get one SANTISMM Lab definition",
"description": "Get one Lab by slug, including formulas, assumptions, related SANTISMM content and its executable endpoint when one exists. Use this after list_labs or search_all; use the named calculate_* tool rather than reimplementing a published formula.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Lab slug, e.g. 'evaluation-sample-size'."
}
}
},
"outputSchema": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"executable",
"owner_server",
"slug",
"kind",
"label",
"title",
"description",
"inputs",
"outputs",
"assumptions",
"version",
"updated",
"canonical_url",
"api_url",
"resource_uri"
],
"properties": {
"kind": {
"enum": [
"calculator",
"converter",
"experiment",
"educational-game"
],
"type": "string"
},
"slug": {
"type": "string"
},
"label": {
"type": "string"
},
"title": {
"type": "string"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"api_url": {
"type": "string"
},
"outputs": {
"type": "array",
"items": {
"type": "string"
}
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"formulas": {
"type": "array",
"items": {
"type": "string"
}
},
"executable": {
"type": "boolean",
"const": true
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"owner_server": {
"type": "string",
"description": "Host that serves and versions this unit."
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"calculation_url": {
"type": "string"
},
"related_content": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"relationship"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"executable",
"owner_server",
"slug",
"category",
"status",
"title",
"canonical_url",
"resource_uri"
],
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string",
"description": "benchmarks, simulators, experiments, games…"
},
"executable": {
"type": "boolean",
"const": false
},
"owner_server": {
"type": "string",
"description": "Host that serves this unit."
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Calculate monthly operating cost, cost per verified outcome, manual baseline, savings, ROI and break-even success rate from explicit assumptions. Use this for an agent business case or scenario comparison; keep every monetary input in the same currency and cite the returned canonical_url.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language for interpretations, assumptions, formulas and warnings. The Labs execution service currently resolves fr/de/ja/zh to English and reports that fallback. |
| toolCost * | number | External tool cost per attempt. |
| retryRate * | number | Extra attempts as a percentage of initial volume. |
| hourlyCost * | number | Fully loaded human hourly cost, in the chosen currency. |
| inputPrice * | number | Model input price per million tokens, in the chosen currency. |
| reviewRate * | number | Share of cases reviewed by a person. |
| inputTokens * | number | Input tokens per agent attempt. |
| outputPrice |
Calculate two different samples: how many independent evaluations are needed to detect at least one failure, and how many are needed to estimate its rate at a chosen margin. Use this when a user asks how many tests are enough; do not interpret zero observed failures as proof of zero risk.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language for interpretations, assumptions, formulas and warnings. The Labs execution service currently resolves fr/de/ja/zh to English and reports that fallback. |
| margin * | number | Margin for estimating the failure rate, in percentage points. |
| confidence * | any | Confidence level, in percent. |
| population * | number | Number of distinct evaluable cases. |
| failureRate * | number | Failure rate to detect, in percent. |
{
"name": "calculate_evaluation_sample_size",
"title": "Calculate an agent evaluation sample size",
"description": "Calculate two different samples: how many independent evaluations are needed to detect at least one failure, and how many are needed to estimate its rate at a chosen margin. Use this when a user asks how many tests are enough; do not interpret zero observed failures as proof of zero risk.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"failureRate",
"confidence",
"margin",
"population"
],
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language for interpretations, assumptions, formulas and warnings. The Labs execution service currently resolves fr/de/ja/zh to English and reports that fallback."
},
"margin": {
"type": "number",
"maximum": 50,
"minimum": 0.1,
"description": "Margin for estimating the failure rate, in percentage points."
},
"confidence": {
"anyOf": [
{
"type": "number",
"const": 90
},
{
"type": "number",
"const": 95
},
{
"type": "number",
"const": 99
}
],
"description": "Confidence level, in percent."
},
"population": {
"type": "number",
"maximum": 1000000000,
"minimum": 1,
"description": "Number of distinct evaluable cases."
},
"failureRate": {
"type": "number",
"maximum": 99.9999,
"minimum": 0.0001,
"description": "Failure rate to detect, in percent."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"schema_version",
"source",
"language",
"requested_locale",
"resolved_locale",
"fallback",
"slug",
"version",
"updated",
"canonical_url",
"api_url",
"methodology_url",
"inputs",
"units",
"interpretation",
"assumptions",
"formulas",
"warnings",
"license",
"results"
],
"properties": {
"slug": {
"type": "string"
},
"units": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"inputs": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"source": {
"type": "string"
},
"api_url": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"name",
"spdx",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"spdx": {
"type": "string"
}
},
"additionalProperties": false
},
"results": {
"type": "object",
"required": [
"detect",
"estimate",
"expected",
"zero"
],
"properties": {
"zero": {
"type": "number"
},
"detect": {
"type": "number"
},
"estimate": {
"type": "number"
},
"expected": {
"type": "number"
}
},
"additionalProperties": false
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"fallback": {
"type": "boolean"
},
"formulas": {
"type": "array",
"items": {
"type": "string"
}
},
"language": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"interpretation": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"resolved_locale": {
"type": "string"
},
"requested_locale": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Calculate review and escalation workload, required FTE, available headroom or backlog, monthly labour cost and sustainable case volume. Use this before production rollout to test whether the stated human-oversight model is operationally credible; the result uses averages and is not a queueing simulation.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language for interpretations, assumptions, formulas and warnings. The Labs execution service currently resolves fr/de/ja/zh to English and reports that fallback. |
| sample * | number | Share of all cases selected for routine review, in percent. |
| volume * | number | Agent cases per month. |
| hoursDay * | number | Paid hours per working day. |
| workdays * | number | Working days per month. |
| reviewers * | number | Available reviewer FTE. |
| hourlyCost * | number | Fully loaded reviewer hourly cost, in the chosen currency. |
| utilization * |
Search the Physical AI dataset — real robot platforms (humanoids, quadrupeds, mobile manipulators, UGVs, drones), documented deployments with sources, the enterprise deployment guide, the autonomy taxonomy and the evidence methodology. Filter by type and taxonomy ids. Each result carries its evidence level, the sources behind it and what is NOT published (limitations); cite canonical_url. Use this for any question about robots, robotic platforms or real robotics deployments; use search_all when the question may also concern the rest of the corpus.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum results. Default: 10. |
| query * | string | What you are looking for, e.g. 'quadruped inspection in industrial plants'. |
| types | array | Restrict to these content types. Omit for all. |
| locale | string | Language of the returned body. Default: en. |
| sectors | array | Sector ids, e.g. inspection, logistics, security, manipulation, energy. |
| families | array | Taxonomy family ids: humanoid, mobile-manipulator, quadruped, ugv, uav. |
| environments | array | Environment ids, e.g. industrial, warehouse, urban, offshore, underground-mining. |
Read one record by type and slug: a platform sheet (specs with test conditions, provenance and sources, autonomy by task, evidence stage, access, lifecycle), a documented case study (sourced facts, published KPIs, lessons), a guide, a cited source by id — or, with type 'source' and no slug, the whole resolved bibliography with each source's evidence level — or the taxonomy and methodology (no slug). A spec or KPI the maker has not published is null with status 'unpublished' — report it as unknown, never estimate it. Use this after search_physical_ai, with the type and slug it returned.
| Parameter | Type | Description |
|---|---|---|
| slug | string | Required for platform, case_study and guide, e.g. 'spot'. For source, a source id; omit it to list every source. Ignored for taxonomy and methodology. |
| type * | string | platform, case_study, guide, source, taxonomy or methodology. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_physical_ai_item",
"title": "Get one Physical AI platform, deployment, guide or reference",
"description": "Read one record by type and slug: a platform sheet (specs with test conditions, provenance and sources, autonomy by task, evidence stage, access, lifecycle), a documented case study (sourced facts, published KPIs, lessons), a guide, a cited source by id — or, with type 'source' and no slug, the whole resolved bibliography with each source's evidence level — or the taxonomy and methodology (no slug). A spec or KPI the maker has not published is null with status 'unpublished' — report it as unknown, never estimate it. Use this after search_physical_ai, with the type and slug it returned.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Required for platform, case_study and guide, e.g. 'spot'. For source, a source id; omit it to list every source. Ignored for taxonomy and methodology."
},
"type": {
"enum": [
"platform",
"case_study",
"guide",
"taxonomy",
"methodology",
"source"
],
"type": "string",
"description": "platform, case_study, guide, source, taxonomy or methodology."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"api_version",
"dataset_version",
"type",
"resource_uri"
],
"properties": {
"type": {
"enum": [
"platform",
"case_study",
"guide",
"taxonomy",
"methodology",
"source"
],
"type": "string"
},
"locale": {
"type": "string"
},
"api_version": {
"type": "string"
},
"resource_uri": {
"type": "string"
},
"dataset_version": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Compare 2–5 platforms side by side on published fields only — payload, runtime, weight, speed, IP rating, temperature range, price, autonomy, coordination, control, perception, environments, sectors, evidence stage, access and lifecycle. Every cell says whether the value is published, unpublished or an editorial estimate, who stated it (manufacturer, press) and under what test conditions. There is no ranking or winner: present it as a table of facts and say which values are unknown. Use this when the user is choosing between named platforms.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
| criteria | array | Fields to compare. Omit for all. |
| platforms * | array | Platform slugs, e.g. ['spot', 'anymal-d']. |
{
"name": "compare_physical_ai_platforms",
"title": "Compare robot platforms on published facts",
"description": "Compare 2–5 platforms side by side on published fields only — payload, runtime, weight, speed, IP rating, temperature range, price, autonomy, coordination, control, perception, environments, sectors, evidence stage, access and lifecycle. Every cell says whether the value is published, unpublished or an editorial estimate, who stated it (manufacturer, press) and under what test conditions. There is no ranking or winner: present it as a table of facts and say which values are unknown. Use this when the user is choosing between named platforms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"platforms"
],
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
},
"criteria": {
"type": "array",
"items": {
"enum": [
"weight_kg",
"payload_kg",
"runtime_min",
"speed_ms",
"height_m",
"ip",
"temp_c",
"price_usd",
"autonomy",
"coordination",
"control",
"perception",
"environments",
"sectors",
"evidence_stage",
"evidence_date",
"access",
"lifecycle"
],
"type": "string"
},
"minItems": 1,
"description": "Fields to compare. Omit for all."
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 5,
"minItems": 2,
"description": "Platform slugs, e.g. ['spot', 'anymal-d']."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"api_version",
"dataset_version"
],
"properties": {
"locale": {
"type": "string"
},
"api_version": {
"type": "string"
},
"model_version": {
"type": "string"
},
"dataset_version": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Run the Physical AI calculator's own 36-month model: manual vs robotic TCO, annual savings, upfront investment, payback month, ROI, coverage, supervision and incidents, plus payback sensitivity to hourly cost, capex, coverage, integration, maintenance and uptime. Every input is optional; use_case applies a published preset first. The response lists the assumptions with their evidence level and the fields_to_validate that are still editorial defaults — tell the user to replace them. Orientative, undiscounted, single currency; not a quote. Use this for the cost, savings or payback of a robot fleet; for an AI-agent business case use calculate_agent_economics.
| Parameter | Type | Description |
|---|---|---|
| risk | string | Hazard level: scales incident cost and adds a labour risk premium. |
| fleet | object | Per robot class; any field omitted keeps its default. |
| locale | string | Language of the returned body. Default: en. |
| use_case | string | Apply this automation-matrix preset before the other inputs. |
| uptime_pct | number | Robot availability, 0–100 %. |
| hourly_cost | number | Fully loaded hourly labour cost, in the chosen currency. |
| days_per_year | integer | Operating days per year. |
| error_rate_pct |
Run the deployment guide's readiness assessment: score per area and overall, the band and its guidance, the weakest area, blockers (items answered 'no') and the questions still unanswered, plus the platforms and documented deployments that match the environment, sector and family, ordered by strength of evidence. Call with no answers first to receive every question. It never recommends a purchase; it shows what is ready, what is missing and what evidence exists. Use this when an organisation asks whether it is ready to deploy robots.
| Parameter | Type | Description |
|---|---|---|
| family | string | Family id: humanoid, mobile-manipulator, quadruped, ugv, uav. |
| locale | string | Language of the returned body. Default: en. |
| sector | string | Sector id, e.g. inspection, logistics, security. |
| answers | object | Readiness item id → yes | partial | no (24 items; ids in the deployment guide's readiness.item_ids). Omit to get every question back as `unanswered`. |
| environment | string | Environment id, e.g. industrial, warehouse, offshore. |
{
"name": "assess_physical_ai_fit",
"title": "Assess readiness for a robotics deployment",
"description": "Run the deployment guide's readiness assessment: score per area and overall, the band and its guidance, the weakest area, blockers (items answered 'no') and the questions still unanswered, plus the platforms and documented deployments that match the environment, sector and family, ordered by strength of evidence. Call with no answers first to receive every question. It never recommends a purchase; it shows what is ready, what is missing and what evidence exists. Use this when an organisation asks whether it is ready to deploy robots.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"family": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Family id: humanoid, mobile-manipulator, quadruped, ugv, uav."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
},
"sector": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Sector id, e.g. inspection, logistics, security."
},
"answers": {
"type": "object",
"description": "Readiness item id → yes | partial | no (24 items; ids in the deployment guide's readiness.item_ids). Omit to get every question back as `unanswered`.",
"propertyNames": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"additionalProperties": {
"enum": [
"yes",
"partial",
"no"
],
"type": "string"
}
},
"environment": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Environment id, e.g. industrial, warehouse, offshore."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"api_version",
"dataset_version"
],
"properties": {
"locale": {
"type": "string"
},
"api_version": {
"type": "string"
},
"model_version": {
"type": "string"
},
"dataset_version": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Traverse the knowledge graph: given a unit, return its neighbours — the units it links to (outgoing) and the units that reference it (incoming), each with the relationship type. Use this after a `get_*` call to widen an answer with adjacent units.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Slug of the unit to start from (or an HRN id when domain is 'handbook'). |
| domain * | string | Core knowledge domain containing the starting unit. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_related",
"title": "Traverse the Knowledge Graph",
"description": "Traverse the knowledge graph: given a unit, return its neighbours — the units it links to (outgoing) and the units that reference it (incoming), each with the relationship type. Use this after a `get_*` call to widen an answer with adjacent units.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain",
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Slug of the unit to start from (or an HRN id when domain is 'handbook')."
},
"domain": {
"enum": [
"knowledge",
"patterns",
"architectures",
"governance",
"handbook"
],
"type": "string",
"description": "Core knowledge domain containing the starting unit."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"unit",
"outgoing",
"incoming"
],
"properties": {
"unit": {
"type": "object",
"required": [
"domain",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
},
"incoming": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name",
"type"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
}
},
"outgoing": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"slug",
"name",
"type"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"type": "string"
},
"domain": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"updated": {
"type": "string"
},
"category": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"sourceType": {
"type": "array",
"items": {
"type": "string"
}
},
"evidenceLevel": {
"type": "string"
},
"confidenceLevel": {
"type": "string"
}
},
"description": "Evidence-First provenance: weight claims by this.",
"additionalProperties": false
},
"how_to_cite": {
"type": "string",
"description": "The citation, already formed — use it verbatim."
},
"resource_uri": {
"type": "string",
"description": "Read this card as an MCP Resource."
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List every place in the Homeric Atlas with its identification class, its confidence score and how many competing identifications it carries. Use this to browse the atlas; use `get_homeric_place` once you have a slug. Identification classes: accepted (an excavated site with consensus), plausible (a real place, contested), speculative (a minority reading or a later tradition), mythical (the poem places it outside the mappable world). Confidence is a published 0-12 rubric - textual, archaeological, scholarly and geographic, 0-3 each - and is an editorial judgement, not a probability.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_homeric_places",
"title": "List Homeric Atlas places",
"description": "List every place in the Homeric Atlas with its identification class, its confidence score and how many competing identifications it carries. Use this to browse the atlas; use `get_homeric_place` once you have a slug. Identification classes: accepted (an excavated site with consensus), plausible (a real place, contested), speculative (a minority reading or a later tradition), mythical (the poem places it outside the mappable world). Confidence is a published 0-12 rubric - textual, archaeological, scholarly and geographic, 0-3 each - and is an editorial judgement, not a probability.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"work": {
"type": "string"
},
"region": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"citation": {
"type": "string"
},
"unlocated": {
"type": "boolean"
},
"confidence": {
"anyOf": [
{
"type": "object",
"properties": {
"band": {
"type": "string"
},
"score": {
"type": "number"
},
"textual": {
"type": "number"
},
"scholarly": {
"type": "number"
},
"geographic": {
"type": "number"
},
"archaeological": {
"type": "number"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"hypotheses": {
"type": "number"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"identification": {
"type": "string"
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one place by slug: every identification proposed for it, each with its own coordinates, class, 0-12 rubric and sources, plus the attested passages. Use this when you need to weigh the evidence for a location, or to cite it; a place the poem does not locate carries no coordinates at all.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Place slug, e.g. 'ithaca'. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_homeric_place",
"title": "Get a Homeric Atlas place",
"description": "Get one place by slug: every identification proposed for it, each with its own coordinates, class, 0-12 rubric and sources, plus the attested passages. Use this when you need to weigh the evidence for a location, or to cite it; a place the poem does not locate carries no coordinates at all.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Place slug, e.g. 'ithaca'."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List every episode of the Iliad and the Odyssey held in the atlas, in reading order, with its passage, the places it involves and how firmly it can be located. Use this to find the episode you want; use `get_homeric_episode` for its theories and sources.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_homeric_episodes",
"title": "List Homeric Atlas episodes",
"description": "List every episode of the Iliad and the Odyssey held in the atlas, in reading order, with its passage, the places it involves and how firmly it can be located. Use this to find the episode you want; use `get_homeric_episode` for its theories and sources.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"work": {
"type": "string"
},
"region": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"citation": {
"type": "string"
},
"unlocated": {
"type": "boolean"
},
"confidence": {
"anyOf": [
{
"type": "object",
"properties": {
"band": {
"type": "string"
},
"score": {
"type": "number"
},
"textual": {
"type": "number"
},
"scholarly": {
"type": "number"
},
"geographic": {
"type": "number"
},
"archaeological": {
"type": "number"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"hypotheses": {
"type": "number"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"identification": {
"type": "string"
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one episode by slug: the passage, the narrative, the competing theories about where it happened (each with its proponent and sources), the confidence rubric and the FAQs. Use this when the question is where an episode took place and who argued for it.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Episode slug, e.g. 'nekyia'. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_homeric_episode",
"title": "Get a Homeric Atlas episode",
"description": "Get one episode by slug: the passage, the narrative, the competing theories about where it happened (each with its proponent and sources), the confidence rubric and the FAQs. Use this when the question is where an episode took place and who argued for it.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Episode slug, e.g. 'nekyia'."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the reconstructed itineraries (the nostos of Odysseus and the others), each with its rival reconstructions scored separately. Use this to see which voyages the atlas reconstructs before fetching one.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
{
"name": "list_homeric_routes",
"title": "List Homeric Atlas routes",
"description": "List the reconstructed itineraries (the nostos of Odysseus and the others), each with its rival reconstructions scored separately. Use this to see which voyages the atlas reconstructs before fetching one.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"slug",
"name"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"work": {
"type": "string"
},
"region": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"citation": {
"type": "string"
},
"unlocated": {
"type": "boolean"
},
"confidence": {
"anyOf": [
{
"type": "object",
"properties": {
"band": {
"type": "string"
},
"score": {
"type": "number"
},
"textual": {
"type": "number"
},
"scholarly": {
"type": "number"
},
"geographic": {
"type": "number"
},
"archaeological": {
"type": "number"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"hypotheses": {
"type": "number"
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"identification": {
"type": "string"
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one route by slug: each reconstruction variant with its ordered stops, the hypothesis chosen at each stop, its confidence rubric and its sources. Use this to compare rival reconstructions of a voyage: they are returned side by side rather than merged.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Route slug, e.g. 'odysseus-nostos'. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_homeric_route",
"title": "Get a Homeric Atlas route",
"description": "Get one route by slug: each reconstruction variant with its ordered stops, the hypothesis chosen at each stop, its confidence rubric and its sources. Use this to compare rival reconstructions of a voyage: they are returned side by side rather than merged.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Route slug, e.g. 'odysseus-nostos'."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the load-bearing claims of the corpus, each tagged as observed_fact, industry_synthesis, santismm_thesis or strategic_hypothesis, with its confidence and the units it underpins. Use this before quoting the handbook to know whether a statement is evidence, a reading of the industry, or a position taken. Filter by `claim_type` to get only what is checkable.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Language of the returned body. Default: en. |
| claim_type | string | Restrict to one rung of the ladder. Omit for all. |
{
"name": "list_claims",
"title": "List the corpus claims and their epistemic status",
"description": "List the load-bearing claims of the corpus, each tagged as observed_fact, industry_synthesis, santismm_thesis or strategic_hypothesis, with its confidence and the units it underpins. Use this before quoting the handbook to know whether a statement is evidence, a reading of the industry, or a position taken. Filter by `claim_type` to get only what is checkable.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
},
"claim_type": {
"enum": [
"observed_fact",
"industry_synthesis",
"santismm_thesis",
"strategic_hypothesis"
],
"type": "string",
"description": "Restrict to one rung of the ladder. Omit for all."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"id",
"slug",
"claim_type",
"confidence_level",
"supports",
"reviewed",
"resource_uri"
],
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"type": "string",
"const": "claim"
},
"reviewed": {
"type": "string"
},
"supports": {
"type": "array",
"items": {
"type": "string"
}
},
"statement": {
"type": "string"
},
"claim_type": {
"enum": [
"observed_fact",
"industry_synthesis",
"santismm_thesis",
"strategic_hypothesis"
],
"type": "string"
},
"resource_uri": {
"type": "string"
},
"confidence_level": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one claim by id (HE-CLAIM-001) or slug: the statement, what it rests on, its structured sources, and — always present — what it does NOT establish and the observation that would retire it. Use this to cite the corpus honestly, or to check whether a result you have just measured confirms or falsifies a claim it makes.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Claim id (e.g. 'HE-CLAIM-001') or slug. |
| locale | string | Language of the returned body. Default: en. |
{
"name": "get_claim",
"title": "Get one claim with its limits and what would refute it",
"description": "Get one claim by id (HE-CLAIM-001) or slug: the statement, what it rests on, its structured sources, and — always present — what it does NOT establish and the observation that would retire it. Use this to cite the corpus honestly, or to check whether a result you have just measured confirms or falsifies a claim it makes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Claim id (e.g. 'HE-CLAIM-001') or slug."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "search_all",
"title": "Search every SANTISMM knowledge surface",
"description": "Search the core corpus, first-party essays, executable Labs, epistemic claims, the Homeric Atlas, the AI benchmarks (professions and benchmark catalogue) and Physical AI (robot platforms, documented deployments, deployment guide) in one call. Use this first when a natural-language question might require a calculation, a long-form essay, a claim audit or a model choice rather than only a core knowledge unit. Results name the next tool to call; calculator-shaped questions are routed toward Labs, 'which AI model for…' questions toward the benchmarks, and robotics questions toward Physical AI.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Question or topic, in English, Spanish, Portuguese, French, German, Japanese or Simplified Chinese."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
},
"surfaces": {
"type": "array",
"items": {
"enum": [
"core",
"articles",
"labs",
"claims",
"homeric_atlas",
"benchmarks",
"physical_ai"
],
"type": "string"
},
"minItems": 1,
"description": "Restrict the search. Omit to search all seven surfaces."
},
"content_locales": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Keep only results whose text is entirely in these languages. `locale` is a presentation preference and still returns substitutions, labelled; this is the hard filter. A result that mixes a language you did not allow is dropped, and so is one that cannot declare its languages."
},
"limit_per_surface": {
"type": "integer",
"maximum": 10,
"description": "Maximum hits from each surface. Default: 5.",
"exclusiveMinimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"requested_locale",
"count",
"results",
"substituted_count",
"unavailable_surfaces"
],
"properties": {
"count": {
"type": "number"
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"surface",
"score",
"source_score",
"rank_within_surface",
"slug",
"title",
"suggested_tool",
"matchedFields",
"matchedTerms"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"slug": {
"type": "string"
},
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"domain": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"surface": {
"enum": [
"core",
"articles",
"labs",
"claims",
"homeric_atlas",
"benchmarks",
"physical_ai"
],
"type": "string"
},
"fallback": {
"type": "boolean",
"description": "True unless the whole result is in the requested language."
},
"matchedTerms": {
"type": "array",
"items": {
"type": "string"
}
},
"source_score": {
"type": "number"
},
"canonical_url": {
"type": "string"
},
"matchedFields": {
"type": "array",
"items": {
"type": "string"
}
},
"content_locale": {
"type": [
"string",
"null"
],
"description": "The single language the whole result is in, or null when it mixes languages. Filter on content_locales, not on this."
},
"suggested_tool": {
"type": "string"
},
"calculation_url": {
"type": "string"
},
"content_locales": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every language this result's text is actually in. More than one means the result mixes them — a localised title with an English summary, for instance."
},
"rank_within_surface": {
"type": "number"
}
},
"additionalProperties": {}
}
},
"empty_reason": {
"type": "string",
"description": "Why a strict content_locales filter returned nothing."
},
"requested_locale": {
"type": "string",
"description": "The locale this search asked for."
},
"substituted_count": {
"type": "number",
"description": "How many results are not in the requested language."
},
"unavailable_surfaces": {
"type": "array",
"items": {
"type": "object",
"required": [
"surface",
"error",
"retry_tool"
],
"properties": {
"error": {
"type": "string"
},
"surface": {
"enum": [
"articles",
"labs",
"benchmarks",
"physical_ai"
],
"type": "string"
},
"retry_tool": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| number |
| Model output price per million tokens, in the chosen currency. |
| successRate * | number | Correctly verified outcomes as a percentage of cases. |
| outputTokens * | number | Output tokens per agent attempt. |
| manualMinutes * | number | Manual handling time per case. |
| monthlyVolume * | number | Cases attempted per month. |
| reviewMinutes * | number | Human review minutes per reviewed case. |
| reworkMinutes * | number | Human rework minutes per failed case. |
{
"name": "calculate_agent_economics",
"title": "Calculate the operational economics of an AI agent",
"description": "Calculate monthly operating cost, cost per verified outcome, manual baseline, savings, ROI and break-even success rate from explicit assumptions. Use this for an agent business case or scenario comparison; keep every monetary input in the same currency and cite the returned canonical_url.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"monthlyVolume",
"manualMinutes",
"hourlyCost",
"inputTokens",
"outputTokens",
"inputPrice",
"outputPrice",
"toolCost",
"retryRate",
"successRate",
"reviewRate",
"reviewMinutes",
"reworkMinutes"
],
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language for interpretations, assumptions, formulas and warnings. The Labs execution service currently resolves fr/de/ja/zh to English and reports that fallback."
},
"toolCost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "External tool cost per attempt."
},
"retryRate": {
"type": "number",
"maximum": 500,
"minimum": 0,
"description": "Extra attempts as a percentage of initial volume."
},
"hourlyCost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Fully loaded human hourly cost, in the chosen currency."
},
"inputPrice": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Model input price per million tokens, in the chosen currency."
},
"reviewRate": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Share of cases reviewed by a person."
},
"inputTokens": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "Input tokens per agent attempt."
},
"outputPrice": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Model output price per million tokens, in the chosen currency."
},
"successRate": {
"type": "number",
"maximum": 100,
"minimum": 1,
"description": "Correctly verified outcomes as a percentage of cases."
},
"outputTokens": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "Output tokens per agent attempt."
},
"manualMinutes": {
"type": "number",
"maximum": 10080,
"minimum": 0,
"description": "Manual handling time per case."
},
"monthlyVolume": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cases attempted per month."
},
"reviewMinutes": {
"type": "number",
"maximum": 10080,
"minimum": 0,
"description": "Human review minutes per reviewed case."
},
"reworkMinutes": {
"type": "number",
"maximum": 10080,
"minimum": 0,
"description": "Human rework minutes per failed case."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"schema_version",
"source",
"language",
"requested_locale",
"resolved_locale",
"fallback",
"slug",
"version",
"updated",
"canonical_url",
"api_url",
"methodology_url",
"inputs",
"units",
"interpretation",
"assumptions",
"formulas",
"warnings",
"license",
"results"
],
"properties": {
"slug": {
"type": "string"
},
"units": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"inputs": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"source": {
"type": "string"
},
"api_url": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"name",
"spdx",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"spdx": {
"type": "string"
}
},
"additionalProperties": false
},
"results": {
"type": "object",
"required": [
"attempts",
"executionCost",
"reviewCost",
"failedCases",
"reworkCost",
"operatingCost",
"manualCost",
"savings",
"roi",
"successfulOutcomes",
"costPerSuccess",
"costPerResolved",
"breakEvenSuccess",
"verdict"
],
"properties": {
"roi": {
"type": "number"
},
"savings": {
"type": "number"
},
"verdict": {
"type": "object",
"required": [
"tone",
"title",
"body"
],
"properties": {
"body": {
"type": "string"
},
"tone": {
"enum": [
"positive",
"watch",
"negative"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": false
},
"attempts": {
"type": "number"
},
"manualCost": {
"type": "number"
},
"reviewCost": {
"type": "number"
},
"reworkCost": {
"type": "number"
},
"failedCases": {
"type": "number"
},
"executionCost": {
"type": "number"
},
"operatingCost": {
"type": "number"
},
"costPerSuccess": {
"type": "number"
},
"costPerResolved": {
"type": "number"
},
"breakEvenSuccess": {
"type": "number"
},
"successfulOutcomes": {
"type": "number"
}
},
"additionalProperties": false
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"fallback": {
"type": "boolean"
},
"formulas": {
"type": "array",
"items": {
"type": "string"
}
},
"language": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"interpretation": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"resolved_locale": {
"type": "string"
},
"requested_locale": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| number |
| Share of paid time available for review and escalation, in percent. |
| reviewMinutes * | number | Minutes per routine review. |
| escalationRate * | number | Share of cases escalated, in percent. |
| escalationMinutes * | number | Minutes per escalation. |
{
"name": "calculate_human_supervision_capacity",
"title": "Calculate human supervision capacity for an AI agent",
"description": "Calculate review and escalation workload, required FTE, available headroom or backlog, monthly labour cost and sustainable case volume. Use this before production rollout to test whether the stated human-oversight model is operationally credible; the result uses averages and is not a queueing simulation.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"volume",
"sample",
"reviewMinutes",
"escalationRate",
"escalationMinutes",
"workdays",
"hoursDay",
"utilization",
"reviewers",
"hourlyCost"
],
"properties": {
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language for interpretations, assumptions, formulas and warnings. The Labs execution service currently resolves fr/de/ja/zh to English and reports that fallback."
},
"sample": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Share of all cases selected for routine review, in percent."
},
"volume": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Agent cases per month."
},
"hoursDay": {
"type": "number",
"maximum": 24,
"minimum": 0.1,
"description": "Paid hours per working day."
},
"workdays": {
"type": "number",
"maximum": 31,
"minimum": 1,
"description": "Working days per month."
},
"reviewers": {
"type": "number",
"maximum": 1000000,
"minimum": 0.1,
"description": "Available reviewer FTE."
},
"hourlyCost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Fully loaded reviewer hourly cost, in the chosen currency."
},
"utilization": {
"type": "number",
"maximum": 100,
"minimum": 1,
"description": "Share of paid time available for review and escalation, in percent."
},
"reviewMinutes": {
"type": "number",
"maximum": 10080,
"minimum": 0,
"description": "Minutes per routine review."
},
"escalationRate": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Share of cases escalated, in percent."
},
"escalationMinutes": {
"type": "number",
"maximum": 10080,
"minimum": 0,
"description": "Minutes per escalation."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"schema_version",
"source",
"language",
"requested_locale",
"resolved_locale",
"fallback",
"slug",
"version",
"updated",
"canonical_url",
"api_url",
"methodology_url",
"inputs",
"units",
"interpretation",
"assumptions",
"formulas",
"warnings",
"license",
"results"
],
"properties": {
"slug": {
"type": "string"
},
"units": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"inputs": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"source": {
"type": "string"
},
"api_url": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"name",
"spdx",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"spdx": {
"type": "string"
}
},
"additionalProperties": false
},
"results": {
"type": "object",
"required": [
"routine",
"escalations",
"workload",
"productivePerFte",
"requiredFte",
"headroom",
"cost",
"backlogDays",
"sustainableVolume"
],
"properties": {
"cost": {
"type": "number"
},
"routine": {
"type": "number"
},
"headroom": {
"type": "number"
},
"workload": {
"type": "number"
},
"backlogDays": {
"type": "number"
},
"escalations": {
"type": "number"
},
"requiredFte": {
"type": "number"
},
"productivePerFte": {
"type": "number"
},
"sustainableVolume": {
"type": "number"
}
},
"additionalProperties": false
},
"updated": {
"type": "string"
},
"version": {
"type": "string"
},
"fallback": {
"type": "boolean"
},
"formulas": {
"type": "array",
"items": {
"type": "string"
}
},
"language": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string",
"description": "Cite this URL."
},
"interpretation": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"resolved_locale": {
"type": "string"
},
"requested_locale": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "search_physical_ai",
"title": "Search Physical AI platforms, deployments, guides and methodology",
"description": "Search the Physical AI dataset — real robot platforms (humanoids, quadrupeds, mobile manipulators, UGVs, drones), documented deployments with sources, the enterprise deployment guide, the autonomy taxonomy and the evidence methodology. Filter by type and taxonomy ids. Each result carries its evidence level, the sources behind it and what is NOT published (limitations); cite canonical_url. Use this for any question about robots, robotic platforms or real robotics deployments; use search_all when the question may also concern the rest of the corpus.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum results. Default: 10."
},
"query": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "What you are looking for, e.g. 'quadruped inspection in industrial plants'."
},
"types": {
"type": "array",
"items": {
"enum": [
"platform",
"case_study",
"guide",
"taxonomy",
"methodology"
],
"type": "string"
},
"minItems": 1,
"description": "Restrict to these content types. Omit for all."
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
},
"sectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"maxItems": 11,
"description": "Sector ids, e.g. inspection, logistics, security, manipulation, energy."
},
"families": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"maxItems": 5,
"description": "Taxonomy family ids: humanoid, mobile-manipulator, quadruped, ugv, uav."
},
"environments": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"maxItems": 11,
"description": "Environment ids, e.g. industrial, warehouse, urban, offshore, underground-mining."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"api_version",
"dataset_version",
"query",
"count",
"results"
],
"properties": {
"count": {
"type": "number"
},
"query": {
"type": "string"
},
"locale": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"type",
"slug",
"title",
"canonical_url",
"api_url",
"resource_uri",
"suggested_tool",
"score"
],
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"enum": [
"platform",
"case_study",
"guide",
"taxonomy",
"methodology"
],
"type": "string"
},
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"api_url": {
"type": "string"
},
"summary": {
"type": "string"
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"resource_uri": {
"type": "string"
},
"canonical_url": {
"type": "string"
},
"evidence_level": {
"type": [
"string",
"null"
]
},
"suggested_tool": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"api_version": {
"type": "string"
},
"dataset_version": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| number |
| % of tasks (≈ one per labour hour) that end in an incident. |
| horizon_months | integer | Default 36. |
| shifts_per_day | integer | Shifts per day. |
| hours_per_shift | number | shifts_per_day × hours_per_shift may not exceed 24. |
| integration_cost | number | One-off integration cost, in the chosen currency. |
| cost_per_incident | number | Average cost of one incident, in the chosen currency. |
| operators_per_shift | integer | People per shift doing the work today. |
| robots_per_supervisor | number | Robots one supervisor can oversee at once. |
{
"name": "calculate_physical_ai_roi",
"title": "Calculate the ROI and TCO of a robot fleet",
"description": "Run the Physical AI calculator's own 36-month model: manual vs robotic TCO, annual savings, upfront investment, payback month, ROI, coverage, supervision and incidents, plus payback sensitivity to hourly cost, capex, coverage, integration, maintenance and uptime. Every input is optional; use_case applies a published preset first. The response lists the assumptions with their evidence level and the fields_to_validate that are still editorial defaults — tell the user to replace them. Orientative, undiscounted, single currency; not a quote. Use this for the cost, savings or payback of a robot fleet; for an AI-agent business case use calculate_agent_economics.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"risk": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"description": "Hazard level: scales incident cost and adds a labour risk premium."
},
"fleet": {
"type": "object",
"properties": {
"uav": {
"type": "object",
"properties": {
"capex": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "Purchase price per unit, incl. dock or base station."
},
"count": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Units of this class in the fleet."
},
"hours_per_day": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Labour hours per day one unit can take over, before uptime."
},
"maintenance_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Annual maintenance as % of capex."
},
"software_per_year": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Software / fleet-management subscription per unit and year."
}
},
"additionalProperties": false
},
"ugv": {
"type": "object",
"properties": {
"capex": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "Purchase price per unit, incl. dock or base station."
},
"count": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Units of this class in the fleet."
},
"hours_per_day": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Labour hours per day one unit can take over, before uptime."
},
"maintenance_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Annual maintenance as % of capex."
},
"software_per_year": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Software / fleet-management subscription per unit and year."
}
},
"additionalProperties": false
},
"humanoid": {
"type": "object",
"properties": {
"capex": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "Purchase price per unit, incl. dock or base station."
},
"count": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Units of this class in the fleet."
},
"hours_per_day": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Labour hours per day one unit can take over, before uptime."
},
"maintenance_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Annual maintenance as % of capex."
},
"software_per_year": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Software / fleet-management subscription per unit and year."
}
},
"additionalProperties": false
},
"quadruped": {
"type": "object",
"properties": {
"capex": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "Purchase price per unit, incl. dock or base station."
},
"count": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Units of this class in the fleet."
},
"hours_per_day": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Labour hours per day one unit can take over, before uptime."
},
"maintenance_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Annual maintenance as % of capex."
},
"software_per_year": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Software / fleet-management subscription per unit and year."
}
},
"additionalProperties": false
}
},
"description": "Per robot class; any field omitted keeps its default.",
"additionalProperties": false
},
"locale": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"ja",
"zh"
],
"type": "string",
"description": "Language of the returned body. Default: en."
},
"use_case": {
"enum": [
"last-mile",
"inspection",
"manipulation",
"security"
],
"type": "string",
"description": "Apply this automation-matrix preset before the other inputs."
},
"uptime_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Robot availability, 0–100 %."
},
"hourly_cost": {
"type": "number",
"maximum": 10000,
"minimum": 0,
"description": "Fully loaded hourly labour cost, in the chosen currency."
},
"days_per_year": {
"type": "integer",
"maximum": 366,
"minimum": 1,
"description": "Operating days per year."
},
"error_rate_pct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "% of tasks (≈ one per labour hour) that end in an incident."
},
"horizon_months": {
"type": "integer",
"maximum": 120,
"minimum": 1,
"description": "Default 36."
},
"shifts_per_day": {
"type": "integer",
"maximum": 24,
"minimum": 1,
"description": "Shifts per day."
},
"hours_per_shift": {
"type": "number",
"maximum": 24,
"minimum": 1,
"description": "shifts_per_day × hours_per_shift may not exceed 24."
},
"integration_cost": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "One-off integration cost, in the chosen currency."
},
"cost_per_incident": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Average cost of one incident, in the chosen currency."
},
"operators_per_shift": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "People per shift doing the work today."
},
"robots_per_supervisor": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "Robots one supervisor can oversee at once."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"api_version",
"dataset_version"
],
"properties": {
"locale": {
"type": "string"
},
"api_version": {
"type": "string"
},
"model_version": {
"type": "string"
},
"dataset_version": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}