从任何 AI 智能体原生查询此语料库
Santismm 知识平台通过 Streamable HTTP 作为公共 MCP 服务器公开。资源可读取完整的、可引用的内容;36 个工具可搜索、导航和执行五个核心领域、第一方文章、Labs、荷马史诗地图集、认识论主张注册表以及 AI 基准测试(哪个模型适合哪种职业)。
Streamable HTTP (JSON-RPC)
无状态 Streamable HTTP:无会话、无 API 密钥、无需安装。该端点支持两个协议时代,因此发送 initialize 的现有客户端可以完全照常工作,您配置的任何内容都无需更改。
协议详情 —— 仅在您使用版本 2026-07-28 或从浏览器调用时适用
在版本 2026-07-28 中,没有 initialize 握手。每个请求都通过 MCP-Protocol-Version: 2026-07-28、Mcp-Method 以及用于工具调用的 Mcp-Name 来声明自身。它还携带一个包含 io.modelcontextprotocol/protocolVersion、.../clientInfo 和 .../clientCapabilities 的 params._meta 信封;空对象是有效的 capabilities 值,但该键是必需的,缺失会导致 400 错误。请求头和请求体会被交叉检查,因此如果请求头与请求体不一致,请求将被拒绝,而不是进行猜测。
仅接受来自 santismm.com、www.santismm.com 和 localhost 的浏览器客户端;在接触传输层之前,任何其他 Origin 都会收到 403 错误。CORS 响应头特意保持开放,以便被拒绝的页面可以读取该 403 错误,而不是显示不透明的网络错误。非浏览器客户端不发送 Origin,因此不受影响。
无需执行工具即可读取内容
使用 resources/list 和 resources/templates/list 来发现稳定的 santismm:// 地址,然后使用 resources/read 获取完整的 JSON 文档。每个有效载荷都保留其公开的 canonical_url 以供引用。即使远程目录暂时不可用,联合的文章和 Lab 模板仍保持可用。
santismm://overviewRead 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.
santismm://authorRead the author's professional facts: name and its other forms, current role with its start date, previous organisations, the frameworks he authored, how to cite, licence, and when these facts were last verified.
santismm://professions/{id}Read one profession's AI model ranking from benchmarks.santismm.com, with its direct or indirect evaluation and the tasks no benchmark measures.
santismm://benchmarks/{slug}Read one benchmark from the AI Agent Benchmarks catalogue: SOTA, saturation, source, radar axis and recorded model scores.
从工作流开始,而不是从空白调用开始
使用 prompts/list 查看此服务器提供的工作流,然后使用 prompts/get 生成一个。locate_in_corpus 在获取之前搜索所有表面,locate_handbook_chapter 直接提供真实的章节标识符,而不是要求你不要猜测;cite_with_provenance 通过规范 URL、证据块及其背后的主张来构建引用。
locate_in_corpusFind 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_chapterHands 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_provenanceProduce 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.
搜索、导航与计算
当智能体需要路由、排序检索、图遍历或确定性执行时,请使用工具。只要工具结果是可读内容,就会链接回匹配的 Resource URI。
get_author_profileGet 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.
get_overviewGet the complete MCP map — start here. Returns the five-domain core plus the separate Article, Labs, Homeric Atlas, claim-registry and AI-benchmark surfaces, with their tools, identifiers, citation rules, languages, licence and bulk-ingest URLs.
search_allSearch the core corpus, first-party essays, executable Labs, epistemic claims, the Homeric Atlas and the AI benchmarks (professions and benchmark catalogue) 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, and 'which AI model for…' questions toward the benchmarks.
list_knowledgeList 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_knowledgeGet 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_patternsList 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_patternGet 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_architecturesList 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_architectureGet 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_governanceList 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_governanceGet 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_handbookList 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_handbookGet 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.
searchRanked 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_articlesList 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_articleGet 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_articlesRanked, 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_professionsList 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.
recommend_model_for_professionGet 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.
compare_modelsPut 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.
list_benchmarksList 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.
get_benchmarkGet 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.
list_labsList 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_labGet 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_economicsCalculate 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_sizeCalculate 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_capacityCalculate 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_relatedTraverse 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_placesList 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_placeGet 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_episodesList 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_episodeGet 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_routesList 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_routeGet 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_claimsList 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_claimGet 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.
结果实际使用的语言
locale 是偏好,不是承诺:某个检索面没有你所要语言的内容时,search_all 依然作答,并说明替换成了哪种语言。每条结果都声明 content_locales——这是一个集合而非单一取值,因为一条结果可能混用语言:职业排名会本地化标题,而摘要仍为英文。
locale- 你希望的语言。没有内容的检索面会用另一种语言替换;结果会被标注,而不会被丢弃。 响应会以
requested_locale回传该取值。 content_locales- 同一字段作为硬过滤:只保留文本完全使用这些语言的结果。结果携带的每一种语言都必须在允许之列,因此本地化标题配英文摘要需要
["es","en"],而无法通过["es"]。无法声明自身语言的结果会被丢弃:保留未知的过滤不算过滤。 content_locale · fallbackcontent_locale指出结果的唯一语言,混用时为null。除非整条结果都使用你所要的语言,fallback均为真;substituted_count为整个响应汇总数量。
各检索面可替换的范围并不相同:核心语料与主张登记册覆盖全部七种语言;可执行 Labs 保留西班牙语基础定义,仅在有译文处替换;荷马地图集回退英文;职业排名提供英文与西班牙文,基准条目仅英文;随笔不做任何协商——各自保持写作时的语言。严格过滤后若无结果,响应会说明原因,而不是让它看起来像内容缺失。
将其添加到您的 MCP 客户端
大多数 MCP 客户端(Claude Desktop、IDE 扩展、自定义智能体)都在其配置中接受 HTTP MCP 服务器。请粘贴:
{
"mcpServers": {
"santismm-knowledge": {
"type": "http",
"url": "https://santismm.com/mcp"
}
}
}获取同一语料库的三种方式
托管端点无需安装任何内容。这两个包都在本地通过 stdio 运行相同的服务器 —— 区别在于语料库的存放位置,这决定了您需要哪一个。
| 方式 | 语料库 | 新鲜度 |
|---|---|---|
| https://santismm.com/mcp | 远程 | 始终最新 |
| npx santismm-knowledge-mcp | 内置核心;文章与 Labs 在线获取 | 在发布时冻结 |
| uvx santismm-knowledge-mcp | 无 —— 代理到端点 | 始终最新 |
npm 包特意设计为快照,因此可能会有所滞后。确实如此:get_overview 会报告做出响应的副本的最新单元日期,而 not_found 会重复该日期,以便智能体能够区分错误的标识符与比其请求内容更旧的语料库。
五个核心领域:知识、模式、架构、治理以及 Harness Engineering(智能体支撑系统工程)手册。search_all 可跨核心、文章、可执行实验室和主张路由自然语言问题;专用工具则公开了 Homeric Atlas。
使用 get_related 遍历链接,这是 /api/graph.json 背后的同一个图。
每个单元都带有证据优先(Evidence-First)的出处信息(证据级别、置信度、来源类型)。
每个工具都会声明一个 outputSchema 并返回经过验证的 structuredContent,因此结果会以类型化数据的形式送达 —— 对于旧版客户端,序列化的 JSON 仍保留在 content 中。
其他地方的同一个服务器
该服务器是一个整体,但有多个入口。其中每一个都是相同的端点和相同的语料库,在页面元数据中被声明为 sameAs,以便爬虫可以对其进行协调合并,而不是将其视为独立的项目进行计数。
未使用 MCP?
核心语料库和相关数据集也以纯文本和 JSON 格式发布。实时发现清单公布的每个直接入口点都链接自 适用于 AI 智能体: