MCP Server

ColdState — Deterministic Knowledge Infrastructure

ai.coldstate/knowledge

What this MCP does

Searches, retrieves, cites and verifies entries in a deterministic multi-domain knowledge base.

coldstate_batch_search
Run several knowledge-base queries in one call against a single consistent kb_snapshot. Returns each query with its ranked results — efficient and snapshot-consistent across the whole batch.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['queries'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Max results per query'}, 'domain': {'type': 'string', 'description': 'Optional domain filter applied to all queries'}, 'queries': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'maxItems': 10, 'minItems': 1, 'description': '1â\x80\x9310 queries'}}}
coldstate_browse_documents
Browse documents in a ColdState index. Indexes are zero-knowledge, so each document is returned as your ref_id plus its state classification and E-score — no stored text. Map ref_id back to your own content.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['index_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max documents to return'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Offset for pagination'}, 'index_id': {'type': 'string', 'pattern': '^idx_[a-f0-9]+$', 'description': 'Index ID, e.g. idx_...'}}}
coldstate_capabilities
Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
coldstate_cite
Get a canonical, reproducible citation for a knowledge entry by id (title, domain, source, content_hash, kb_snapshot). Cite a fact so it can be re-verified later with coldstate_verify.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Stable knowledge entry id'}}}
coldstate_domains
List all available knowledge domains in ColdState's global knowledge base with entry counts.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
coldstate_explain
Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['index_id', 'query', 'doc_id'], 'properties': {'query': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'The search query to explain against'}, 'doc_id': {'type': 'string', 'pattern': '^\\d+$|^doc_\\d+$', 'description': 'Document ID, e.g. "doc_42" or "42"'}, 'index_id': {'type': 'string', 'pattern': '^idx_[a-f0-9]+$', 'description': 'Index ID, e.g. idx_...'}}}
coldstate_fetch
Fetch a single knowledge-base entry verbatim by its stable id (e.g. "eng_000229f438f7cebd"). Deterministic retrieval — returns the full record plus a content_hash and kb_snapshot for reproducible citation.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Stable knowledge entry id, e.g. eng_... or soc_...'}}}
coldstate_isomorph
Cross-domain structural analog: given a knowledge entry id, find its closest structural twin in each OTHER domain ("same structure, different domain"). Deterministic. Use coldstate_resolve to turn a name into an id first.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Stable knowledge entry id, e.g. eng_... or soc_...'}, 'limit': {'type': 'integer', 'default': 8, 'maximum': 35, 'minimum': 1, 'description': 'Max cross-domain analogs (one per domain)'}}}
coldstate_list_indexes
List all your ColdState indexes with their status, mode, document count, and domain preset.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
coldstate_related
Find knowledge entries deterministically related to a given entry id via ColdState's concept-cluster graph. Returns same-cluster and neighboring-cluster entries, each tagged with its relation and a cross_domain flag. Same id ⇒ same neighbors.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Stable knowledge entry id, e.g. eng_... or soc_...'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Max related entries'}}}
coldstate_resolve
Resolve a name, alias, or surface form to its canonical ColdState knowledge entry (id + title). Deterministic: an exact title match wins, else the top relevance-Ψ entry. Returns the canonical entry plus alternatives. Use the returned id with coldstate_fetch / coldstate_related.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 4, 'maximum': 5, 'minimum': 1, 'description': 'Max alternative candidates'}, 'query': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'The name/term/alias to resolve'}}}
coldstate_search
Search a ColdState index by collection name or index ID. Returns ranked results with Ψ scores and state classification (CRYSTALLINE/FLUID/REACTIVE/DECOHERENT). Provide exactly one of `collection` or `index_id`.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 100, 'minimum': 1, 'description': 'Max results to return'}, 'query': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'The search query'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Offset for pagination'}, 'index_id': {'type': 'string', 'pattern': '^idx_[a-f0-9]+$', 'description': 'Index ID to search, e.g. idx_... (mutually exclusive with collection)'}, 'collection': {'type': 'string', 'description': 'Collection name to search (mutually exclusive with index_id)'}}}
coldstate_search_global
Search ColdState's global knowledge base (48.4M+ entries across 35 domains including SCIENCE, MEDICINE, TECHNOLOGY, HISTORY, etc). Returns deterministically ranked results with Ψ relevance scores and a state classification. Optionally filter by domain.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 100, 'minimum': 1, 'description': 'Max results to return'}, 'query': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'The search query'}, 'domain': {'type': 'string', 'description': 'Filter by knowledge domain (e.g. MEDICINE, SCIENCE, TECHNOLOGY, HISTORY, LAW, CODE). Case-insensitive.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Offset for pagination'}}}
coldstate_snapshot
Get the current knowledge-base snapshot/version id. Pin this kb_snapshot for reproducibility: the same query against the same kb_snapshot returns identical results.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
coldstate_stats
Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'query': {'type': 'string', 'maxLength': 2000, 'description': 'Optional query to get coverage/state stats for'}, 'domain': {'type': 'string', 'description': 'Optional domain filter (with query)'}}}
coldstate_verify
Verify a previously-cited knowledge fact is unchanged. Provide the entry id and the content_hash you stored earlier; returns whether it still matches the current knowledge base. The trust primitive for AI-to-AI fact-checking.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'content_hash'], 'properties': {'id': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Stable knowledge entry id'}, 'content_hash': {'type': 'string', 'maxLength': 64, 'minLength': 8, 'description': 'The content_hash from a previous fetch/cite'}}}
Added
coldstate_isomorph
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_capabilities
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_stats
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_batch_search
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_resolve
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_related
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_snapshot
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_verify
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_cite
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_fetch
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_domains
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_search_global
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_explain
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_browse_documents
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_list_indexes
Oct. 2, 2026, 2:40 a.m.
Added
coldstate_search
Oct. 2, 2026, 2:40 a.m.