Model Context Protocol

Consulta este corpus de forma nativa desde cualquier agente de IA

La plataforma de conocimiento Santismm se expone como servidor MCP público sobre Streamable HTTP. Los Resources leen contenido completo y citable; 30 herramientas buscan, recorren y ejecutan cinco dominios centrales, ensayos propios, Labs, el Atlas homérico y el registro epistémico de afirmaciones.

Transporte

Streamable HTTP (JSON-RPC)

Streamable HTTP sin estado: sin sesión, sin clave de API, sin nada que instalar. El endpoint sirve las dos eras del protocolo, así que un cliente que envíe initialize sigue funcionando igual que antes y no tienes que cambiar nada de lo que ya tengas configurado.

Detalles del protocolo — solo si usas la revisión 2026-07-28 o llamas desde un navegador

En la revisión 2026-07-28 no hay saludo initialize. Cada petición se declara con MCP-Protocol-Version: 2026-07-28, Mcp-Method y, para una llamada a herramienta, Mcp-Name. Además lleva un sobre params._meta con io.modelcontextprotocol/protocolVersion, .../clientInfo y .../clientCapabilities; un objeto vacío es un valor válido de capacidades, pero la clave es obligatoria y su ausencia devuelve un 400. Cabeceras y cuerpo se contrastan, así que una petición cuyas cabeceras no concuerden con su cuerpo se rechaza en vez de adivinarse.

Los clientes de navegador solo se aceptan desde santismm.com, www.santismm.com y localhost; cualquier otro Origin recibe un 403 antes de tocar el transporte. Las cabeceras CORS se dejan abiertas a propósito, para que una página rechazada pueda leer ese 403 en vez de un error de red opaco. Los clientes que no son navegador no envían Origin y no les afecta.

Resources

Lee contenido sin ejecutar una herramienta

Usa resources/list y resources/templates/list para descubrir direcciones santismm:// estables, y después resources/read para obtener el documento JSON completo. Cada respuesta conserva su canonical_url pública para citarla. Las plantillas federadas de Articles y Labs siguen disponibles aunque su catálogo remoto caiga temporalmente.

santismm://overview

Read the corpus map, licences, languages, extensions and bulk-ingest URLs.

santismm://knowledge/{locale}/{slug}

Read one complete knowledge unit, localised and carrying provenance plus canonical citation URLs.

santismm://patterns/{locale}/{slug}

Read one complete patterns unit, localised and carrying provenance plus canonical citation URLs.

santismm://architectures/{locale}/{slug}

Read one complete architectures unit, localised and carrying provenance plus canonical citation URLs.

santismm://governance/{locale}/{slug}

Read one complete governance unit, localised and carrying provenance plus canonical citation URLs.

santismm://handbook/{locale}/{id}

Read one complete Handbook chapter by stable id or slug and locale.

santismm://articles/{slug}

Read one complete first-party essay from the canonical Articles API.

santismm://labs/{slug}

Read one calculator, converter, experiment or educational-game definition without executing it.

santismm://homeric/{kind}/{locale}/{slug}

Read one place, episode or route with competing identifications and rubric evidence.

santismm://claims/{locale}/{id}

Read one load-bearing claim, including limits and falsification criteria.

Prompts

Empieza por un flujo, no por una llamada en blanco

Usa prompts/list para ver los flujos que publica este servidor y prompts/get para renderizar uno. locate_in_corpus busca en todas las superficies antes de descargar, locate_handbook_chapter entrega los identificadores reales de los capítulos en vez de pedirte que no los inventes, y cite_with_provenance recorre una cita por su URL canónica, su bloque de evidencia y la afirmación que hay detrás.

locate_in_corpus

Find which surface holds a concept before fetching it. Searches every surface first, so a slug that lives in one domain is not requested from another.

locate_handbook_chapter

Hands over the real chapter identifiers and their titles, so a chapter is requested by an id that exists rather than one inferred by analogy.

cite_with_provenance

Produce a citation that carries the canonical URL, the Evidence-First block and — when the statement is load-bearing — the epistemic level and retraction condition of the claim behind it.

Herramientas

Busca, recorre y calcula

Usa herramientas cuando el agente necesite enrutado, recuperación ordenada, navegación por el grafo o ejecución determinista. Los resultados enlazan el Resource URI correspondiente cuando contienen material legible.

get_overview

Get the complete MCP map — start here. Returns the five-domain core plus the separate Article, Labs, Homeric Atlas and claim-registry surfaces, with their tools, identifiers, citation rules, languages, licence and bulk-ingest URLs.

search_all

Search the core corpus, first-party essays, executable Labs, epistemic claims and the Homeric Atlas in one call. Use this first when a natural-language question might require a calculation, a long-form essay or a claim audit rather than only a core knowledge unit. Results name the next tool to call; calculator-shaped questions are routed toward Labs.

list_knowledge

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.

get_knowledge

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.

list_patterns

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.

get_pattern

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.

list_architectures

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.

get_architecture

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.

list_governance

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.

get_governance

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.

list_handbook

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.

get_handbook

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.

search

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.

list_articles

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.

get_article

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.

search_articles

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.

list_labs

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.

get_lab

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.

calculate_agent_economics

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.

calculate_evaluation_sample_size

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.

calculate_human_supervision_capacity

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.

get_related

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.

list_homeric_places

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.

get_homeric_place

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.

list_homeric_episodes

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.

get_homeric_episode

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.

list_homeric_routes

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.

get_homeric_route

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.

list_claims

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.

get_claim

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.

Configuración del cliente

Añádelo a tu cliente MCP

La mayoría de clientes MCP (Claude Desktop, extensiones de IDE, agentes propios) aceptan un servidor MCP por HTTP en su configuración. Pega esto:

{
  "mcpServers": {
    "santismm-knowledge": {
      "type": "http",
      "url": "https://santismm.com/mcp"
    }
  }
}
Instalación

Tres formas de llegar al mismo corpus

El endpoint alojado no requiere instalar nada. Los dos paquetes ejecutan el mismo servidor en local sobre stdio — la diferencia es dónde vive el corpus, y eso decide cuál te conviene.

CómoCorpusFrescura
https://santismm.com/mcpremotosiempre al día
npx santismm-knowledge-mcpnúcleo incluido; Articles y Labs en líneacongelado al publicar
uvx santismm-knowledge-mcpninguno — hace de proxy al endpointsiempre al día

El paquete de npm es una instantánea a propósito, así que puede ir atrasado. Y lo dice: get_overview informa de la fecha de la unidad más reciente que contiene esa copia, y el not_found la repite, de modo que un agente distingue un identificador equivocado de un corpus anterior a lo que pregunta.

Cinco dominios centrales: conocimiento, patrones, arquitecturas, gobernanza y el Harness Engineering Handbook. search_all enruta preguntas en lenguaje natural por el núcleo, Articles, Labs ejecutables y afirmaciones; herramientas dedicadas exponen el Atlas homérico.

Recorre los enlaces con get_related, el mismo grafo que hay detrás de /api/graph.json.

Cada unidad lleva procedencia Evidence-First (nivel de evidencia, confianza, tipos de fuente).

Cada herramienta declara un outputSchema y devuelve structuredContent validado, así que los resultados llegan como datos tipados — el JSON serializado sigue en content para clientes antiguos.

También listado en

El mismo servidor, en otros sitios

Este servidor es una sola cosa con varias puertas de entrada. Todas apuntan al mismo endpoint y al mismo corpus, y se declaran como sameAs en los metadatos de la página para que un rastreador las reconcilie en vez de contar proyectos distintos.

Otras superficies legibles por máquina

¿No usas MCP?

El corpus central y los datasets asociados también se publican como texto plano y JSON. Cada punto de entrada directo anunciado por el manifiesto de descubrimiento está enlazado desde Para agentes de IA: