Skip to main content
Glama
santismm-knowledge

santismm-knowledge

Official

santismm-knowledge-mcp

santismm-knowledge-mcp MCP server

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 start

The 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-mcp

Or 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-mcp

The 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 tools
assess_physical_ai_fitAssess readiness for a robotics deploymentA
Read-onlyIdempotent
Inspect

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 agentA
Read-onlyIdempotent
Inspect

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 sizeA
Read-onlyIdempotent
Inspect

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 agentA
Read-onlyIdempotent
Inspect

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 fleetA
Read-onlyIdempotent
Inspect

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 resultsA
Read-onlyIdempotent
Inspect

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 factsA
Read-onlyIdempotent
Inspect

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 ArchitectureA
Read-onlyIdempotent
Inspect

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 essayA
Read-onlyIdempotent
Inspect

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 corpusA
Read-onlyIdempotent
Inspect

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 scoresA
Read-onlyIdempotent
Inspect

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 itA
Read-onlyIdempotent
Inspect

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 UnitA
Read-onlyIdempotent
Inspect

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 ChapterA
Read-onlyIdempotent
Inspect

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 episodeA
Read-onlyIdempotent
Inspect

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 placeA
Read-onlyIdempotent
Inspect

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 routeA
Read-onlyIdempotent
Inspect

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 UnitA
Read-onlyIdempotent
Inspect

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 definitionA
Read-onlyIdempotent
Inspect

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 HereA
Read-onlyIdempotent
Inspect

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 PatternA
Read-onlyIdempotent
Inspect

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 referenceA
Read-onlyIdempotent
Inspect

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 ArchitecturesA
Read-onlyIdempotent
Inspect

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 essaysA
Read-onlyIdempotent
Inspect

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.comA
Read-onlyIdempotent
Inspect

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 statusA
Read-onlyIdempotent
Inspect

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 UnitsA
Read-onlyIdempotent
Inspect

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 ChaptersA
Read-onlyIdempotent
Inspect

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 episodesA
Read-onlyIdempotent
Inspect

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 placesA
Read-onlyIdempotent
Inspect

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 routesA
Read-onlyIdempotent
Inspect

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 UnitsA
Read-onlyIdempotent
Inspect

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 LabsA
Read-onlyIdempotent
Inspect

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 PatternsA
Read-onlyIdempotent
Inspect

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 rankingA
Read-onlyIdempotent
Inspect

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 professionA
Read-onlyIdempotent
Inspect

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

search_allSearch every SANTISMM knowledge surfaceA
Read-onlyIdempotent
Inspect

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 essaysA
Read-onlyIdempotent
Inspect

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 methodologyA
Read-onlyIdempotent
Inspect

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

    A3.9/5.0

    Scored across 41 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers