ColdState — Deterministic Knowledge Infrastructure
Deterministic knowledge for AI agents: search, fetch, cite and verify a 48M-entry knowledge base.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'coldstate_browse_documents' description lacks action verbin coldstate_browse_documents
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"knowledge": {
"url": "https://cold-api.coldstate.ai/mcp"
}
}
}Remote endpoints
https://cold-api.coldstate.ai/mcpstreamable-httpWhat it can do
Tool inventory
Tools (16)
🟢coldstate_search(query, collection, index_id, limit, offset)
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`.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "The search query"
},
"collection": {
"description": "Collection name to search (mutually exclusive with index_id)",
"type": "string"
},
"index_id": {
"description": "Index ID to search, e.g. idx_... (mutually exclusive with collection)",
"type": "string",
"pattern": "^idx_[a-f0-9]+$"
},
"limit": {
"default": 10,
"description": "Max results to return",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"description": "Offset for pagination",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_list_indexes
List all your ColdState indexes with their status, mode, document count, and domain preset.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_browse_documents(index_id, limit, offset)
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.
Input Schema
{
"type": "object",
"properties": {
"index_id": {
"type": "string",
"pattern": "^idx_[a-f0-9]+$",
"description": "Index ID, e.g. idx_..."
},
"limit": {
"default": 20,
"description": "Max documents to return",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"description": "Offset for pagination",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"index_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_explain(index_id, query, doc_id)
Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.
Input Schema
{
"type": "object",
"properties": {
"index_id": {
"type": "string",
"pattern": "^idx_[a-f0-9]+$",
"description": "Index ID, e.g. idx_..."
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "The search query to explain against"
},
"doc_id": {
"type": "string",
"pattern": "^\\d+$|^doc_\\d+$",
"description": "Document ID, e.g. \"doc_42\" or \"42\""
}
},
"required": [
"index_id",
"query",
"doc_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_search_global(query, domain, limit, offset)
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.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "The search query"
},
"domain": {
"description": "Filter by knowledge domain (e.g. MEDICINE, SCIENCE, TECHNOLOGY, HISTORY, LAW, CODE). Case-insensitive.",
"type": "string"
},
"limit": {
"default": 10,
"description": "Max results to return",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"description": "Offset for pagination",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_domains
List all available knowledge domains in ColdState's global knowledge base with entry counts.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_fetch(id)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Stable knowledge entry id, e.g. eng_... or soc_..."
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_cite(id)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Stable knowledge entry id"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_verify(id, content_hash)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Stable knowledge entry id"
},
"content_hash": {
"type": "string",
"minLength": 8,
"maxLength": 64,
"description": "The content_hash from a previous fetch/cite"
}
},
"required": [
"id",
"content_hash"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_related(id, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Stable knowledge entry id, e.g. eng_... or soc_..."
},
"limit": {
"default": 10,
"description": "Max related entries",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_resolve(query, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "The name/term/alias to resolve"
},
"limit": {
"default": 4,
"description": "Max alternative candidates",
"type": "integer",
"minimum": 1,
"maximum": 5
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_batch_search(queries, domain, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"queries": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"description": "1–10 queries"
},
"domain": {
"description": "Optional domain filter applied to all queries",
"type": "string"
},
"limit": {
"default": 5,
"description": "Max results per query",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"queries"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_stats(query, domain)
Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Optional query to get coverage/state stats for",
"type": "string",
"maxLength": 2000
},
"domain": {
"description": "Optional domain filter (with query)",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢coldstate_isomorph(id, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Stable knowledge entry id, e.g. eng_... or soc_..."
},
"limit": {
"default": 8,
"description": "Max cross-domain analogs (one per domain)",
"type": "integer",
"minimum": 1,
"maximum": 35
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence