santismm-knowledge
OfficialA read-only MCP server over the Santismm knowledge platform: search, browse and cite agentic-AI knowledge, essays, calculators, claims and Homeric Atlas data.
Map the corpus —
get_overviewreturns the five domains, extensions, locales, licence and bulk-ingest URLsSearch everything —
search_allqueries all five surfaces at once;searchdoes ranked keyword search across the core corpusBrowse & fetch core domains — list/get pairs for knowledge units, patterns, reference architectures, governance units and the Harness Engineering Handbook chapters
Traverse the knowledge graph —
get_relatedreturns outgoing and incoming neighbours with relationship typesRead first-party essays — list, get and full-text search long-form articles on articles.santismm.com
Run published calculations — Labs tools for agent economics, evaluation sample size and human supervision capacity, returning formulas, assumptions and warnings
Audit claims — list and get epistemic claims tagged observed_fact / industry_synthesis / santismm_thesis / strategic_hypothesis, including what would refute them
Explore the Homeric Atlas — places, episodes and routes with identification classes, 0–12 confidence rubrics and rival reconstructions
Cite correctly — every result carries a canonical URL, resource URI and licence/provenance metadata (en/es/pt and more)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@santismm-knowledge Show me the core AI governance principles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
santismm-knowledge-mcp
MCP server for the Santismm Knowledge Platform — five core knowledge domains, first-party essays, Homeric Atlas datasets and epistemic claims.
This repository is generated from the platform at santismm.com. Do not edit it by hand; changes are overwritten on the next sync. Corrections go through the site.
Use it without installing anything
The same server is hosted, so most people want the endpoint rather than this repository:
{ "mcpServers": { "santismm-knowledge": { "type": "http", "url": "https://santismm.com/mcp" } } }Docs: https://santismm.com/en/mcp · Registry: com.santismm/knowledge
Related MCP server: Cerebrito MCP Server
Where this server is listed
Derived from the same list the site renders on its own MCP page, so a registry added there is linked from here too — and a directory that checks for a backlink before ranking a server finds one without anybody remembering to add it.
Run it locally (stdio)
npm ci && npm run build && npm startThe core corpus ships in content/ and is read from disk, so its tools work
offline. The federated Article, Labs and benchmark tools read their canonical
first-party APIs over HTTPS (benchmarks: SANTISMM_BENCHMARKS_URL). Point the
core corpus elsewhere with SANTISMM_CONTENT_DIR.
Install from npm
npx santismm-knowledge-mcpOr in an MCP client config (stdio):
{ "mcpServers": { "santismm-knowledge": { "command": "npx", "args": ["santismm-knowledge-mcp"] } } }The npm package carries the corpus frozen at publish time; this repository and the hosted endpoint update continuously. When freshness matters, prefer the endpoint.
Install from PyPI (Python)
uvx santismm-knowledge-mcpThe Python package (in python/) is a zero-dependency stdio
proxy to the hosted endpoint — it ships no corpus, so it is always fresh.
{ "mcpServers": { "santismm-knowledge": { "command": "uvx", "args": ["santismm-knowledge-mcp"] } } }Licences
Code is MIT (LICENSE); the knowledge corpus in content/ is
CC BY 4.0 (content/LICENSE) — two licences because CC BY
is not a software licence and MIT is not a content licence.
What it exposes
41 read-only tools over knowledge, patterns, architectures, governance, the
Harness Engineering Handbook, first-party Articles, Labs and the AI benchmarks,
each declaring an
outputSchema and returning validated structuredContent. Every tool is
annotated readOnlyHint: true, destructiveHint: false and
idempotentHint: true. The federated Article, Labs and benchmark tools
declare openWorldHint: true; local-corpus tools remain false.
Content in seven languages (en/es/pt/fr/de/ja/zh).
Licence
Code: MIT. Content: Content © Santiago Santa María Morales, licensed CC BY 4.0. Attribution required: credit the author and link the canonical URL. (CC-BY-4.0, https://creativecommons.org/licenses/by/4.0/).
Available Tools
41 toolsassess_physical_ai_fitAssess readiness for a robotics deploymentARead-onlyIdempotentInspect
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.
Inputs: family, locale, sector, answers, +1 more. Returns: locale, api_version, model_version, dataset_version
calculate_agent_economicsCalculate the operational economics of an AI agentARead-onlyIdempotentInspect
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.
Inputs: toolCost (required), retryRate (required), hourlyCost (required), inputPrice (required), +10 more. Returns: slug, units, inputs, source, +16 more
calculate_evaluation_sample_sizeCalculate an agent evaluation sample sizeARead-onlyIdempotentInspect
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.
Inputs: margin (required), confidence (required), population (required), failureRate (required), +1 more. Returns: slug, units, inputs, source, +16 more
calculate_human_supervision_capacityCalculate human supervision capacity for an AI agentARead-onlyIdempotentInspect
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.
Inputs: sample (required), volume (required), hoursDay (required), workdays (required), +7 more. Returns: slug, units, inputs, source, +16 more
calculate_physical_ai_roiCalculate the ROI and TCO of a robot fleetARead-onlyIdempotentInspect
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.
Inputs: risk, fleet, locale, use_case, +11 more. Returns: locale, api_version, model_version, dataset_version
compare_modelsCompare AI models on published benchmark resultsARead-onlyIdempotentInspect
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.
Inputs: models (required), profession. Returns: note, models, benchmarks, profession, +5 more
compare_physical_ai_platformsCompare robot platforms on published factsARead-onlyIdempotentInspect
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.
Inputs: platforms (required), locale, criteria. Returns: locale, api_version, model_version, dataset_version
get_architectureGet an Agentic Reference ArchitectureARead-onlyIdempotentInspect
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.
Inputs: slug (required), locale. Returns: id, body, name, slug, +25 more
get_articleGet a first-party essayARead-onlyIdempotentInspect
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.
Inputs: slug (required). Returns: body, slug, title, topics, +8 more
get_author_profileWho wrote this corpusARead-onlyIdempotentInspect
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.
Inputs: no named parameters. Returns: name, license, profiles, frameworks, +10 more
get_benchmarkGet one AI benchmark with its SOTA and model scoresARead-onlyIdempotentInspect
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.
Inputs: slug (required). Returns: list, name, slug, radar, +7 more
get_claimGet one claim with its limits and what would refute itARead-onlyIdempotentInspect
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.
Inputs: id (required), locale. Returns: object
get_governanceGet an AI Governance UnitARead-onlyIdempotentInspect
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.
Inputs: slug (required), locale. Returns: id, body, name, slug, +25 more
get_handbookGet a Harness Engineering Handbook ChapterARead-onlyIdempotentInspect
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.
Inputs: id (required), locale. Returns: id, body, name, slug, +25 more
get_homeric_episodeGet a Homeric Atlas episodeARead-onlyIdempotentInspect
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.
Inputs: slug (required), locale. Returns: object
get_homeric_placeGet a Homeric Atlas placeARead-onlyIdempotentInspect
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.
Inputs: slug (required), locale. Returns: object
get_homeric_routeGet a Homeric Atlas routeARead-onlyIdempotentInspect
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.
Inputs: slug (required), locale. Returns: object
get_knowledgeGet an Agentic AI Knowledge UnitARead-onlyIdempotentInspect
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.
Inputs: slug (required), locale. Returns: id, body, name, slug, +25 more
get_labGet one SANTISMM Lab definitionARead-onlyIdempotentInspect
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.
Inputs: slug (required). Returns: object
get_overviewCorpus Overview — Start HereARead-onlyIdempotentInspect
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.
Inputs: no named parameters. Returns: bulk, next, site, total, +9 more
get_patternGet an Enterprise AI PatternARead-onlyIdempotentInspect
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.
Inputs: slug (required), locale. Returns: id, body, name, slug, +25 more
get_physical_ai_itemGet one Physical AI platform, deployment, guide or referenceARead-onlyIdempotentInspect
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, 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.
Inputs: type (required), slug, locale. Returns: type, locale, api_version, resource_uri, +1 more
list_architecturesList Agentic Reference ArchitecturesARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_articlesList first-party essaysARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_benchmarksList the AI benchmarks tracked by benchmarks.santismm.comARead-onlyIdempotentInspect
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.
Inputs: list. Returns: count, results, dataset_version
list_claimsList the corpus claims and their epistemic statusARead-onlyIdempotentInspect
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.
Inputs: locale, claim_type. Returns: count, results
list_governanceList AI Governance UnitsARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_handbookList Harness Engineering Handbook ChaptersARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_homeric_episodesList Homeric Atlas episodesARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_homeric_placesList Homeric Atlas placesARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_homeric_routesList Homeric Atlas routesARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_knowledgeList Agentic AI Knowledge UnitsARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_labsList calculators, converters, experiments and educational LabsARead-onlyIdempotentInspect
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.
Inputs: kind. Returns: count, results
list_patternsList Enterprise AI PatternsARead-onlyIdempotentInspect
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.
Inputs: locale. Returns: count, results
list_professionsList the professions with an AI model rankingARead-onlyIdempotentInspect
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.
Inputs: group, locale, evaluation. Returns: count, results
recommend_model_for_professionWhich AI model is best for a professionARead-onlyIdempotentInspect
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.
Inputs: id (required), limit, locale. Returns: id, name, group, picks, +14 more
searchSearch Harness Engineering & Agentic AIARead-onlyIdempotentInspect
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.
Inputs: query (required), limit, locale, domains. Returns: count, query, results
search_allSearch every SANTISMM knowledge surfaceARead-onlyIdempotentInspect
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.
Inputs: query (required), locale, surfaces, content_locales, +1 more. Returns: count, query, results, empty_reason, +3 more
search_articlesSearch first-party essaysARead-onlyIdempotentInspect
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.
Inputs: query (required), limit, locale. Returns: count, query, results
search_physical_aiSearch Physical AI platforms, deployments, guides and methodologyARead-onlyIdempotentInspect
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.
Inputs: query (required), limit, types, locale, +3 more. Returns: count, query, locale, results, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Tools are mostly partitioned by domain and by list/get/search/calculate/compare/assess patterns, and descriptions explicitly route between global and domain-specific searches. The main overlap is among search, search_all, search_articles and search_physical_ai, plus generic search vs list browsing, but the guidance is strong enough to avoid most misselection.
Uses a predictable snake_case verb_noun convention: list_*, get_*, search_*, calculate_*, compare_*, assess_*. Minor deviations such as bare search/search_all, recommend_model_for_profession and get_related are readable and do not seriously undermine consistency.
41 tools is high for a single MCP server; although the breadth reflects many federated domains, the surface exceeds the 25+ threshold and forces agents to choose among many list/get/search variants. Consolidation via generic domain parameters or grouped endpoints would improve usability.
Coverage is broad: browse/retrieve/search for core units, articles, benchmarks, labs, physical AI, Homeric atlas and claims, plus graph traversal and calculators. Minor gaps exist around model-level retrieval and invoking arbitrary Lab endpoints, but no major workflow dead ends.
Maintenance
Related MCP Connectors
Knowledge base MCP for AI agents on iknow.dev. Search, read, and maintain via OAuth.
Make your knowledge agent-ready. One MCP endpoint, 5 connectors, 3 search modes.
Knowledge base for AI agents: search, read, tasks; write, correct, report outcomes via /mcp/write.
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to Agno framework documentation for AI agents, enabling search and retrieval of SDK references, API endpoints, code examples, and integration guides through MCP-compatible tools.73MIT
- FlicenseNot gradedqualityBmaintenanceMCP server that exposes the knowledge base of the Cumplimiento Digital project, allowing AI agents to query KB entries, project status, endpoints, and glossary via MCP tools.-
- AlicenseNot gradedqualityCmaintenanceProvides enterprise knowledge management capabilities via MCP, enabling semantic search across the knowledge base, retrieval of full documents by ID, and search over enterprise project cases.MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLM agents to query a structured knowledge library for search, explanations, related concepts, learning paths, examples, and cross-domain references via MCP.Apache 2.0