ColdState — Deterministic Knowledge Infrastructure

Official16 tools

by coldstate

Deterministic knowledge for AI agents: search, fetch, cite and verify a 48M-entry knowledge base.

ai.coldstate/knowledge Model Context Protocol (MCP) Server

The ai.coldstate/knowledge MCP server provides deterministic knowledge for AI agents. It supports searching, fetching, citing, and verifying a knowledge base with 48M entries, enabling agents to ground outputs in retrieved, cited, and verified information.

🛠️ Key Features

Deterministic knowledge for AI agents
Search the knowledge base
Fetch knowledge entries
Cite retrieved content
Verify results against a 48M-entry knowledge base

🚀 Use Cases

Retrieval of relevant knowledge for agent workflows
Generating responses with citations
Verifying fetched information for accuracy

⚡ Developer Benefits

Consistent (deterministic) knowledge retrieval
Clear workflow steps: search, fetch, cite, verify
Access to a large 48M-entry knowledge base

Captured live from the server via tools/list.

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`.

Parameters5

query	string	required	The search query
collection	string	optional	Collection name to search (mutually exclusive with index_id)
index_id	string	optional	Index ID to search, e.g. idx_... (mutually exclusive with collection)
limit	integer	optional	Max results to return
offset	integer	optional	Offset for pagination

Raw 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

index_id	string	required	Index ID, e.g. idx_...
limit	integer	optional	Max documents to return
offset	integer	optional	Offset for pagination

Raw 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

Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.

Parameters3

index_id	string	required	Index ID, e.g. idx_...
query	string	required	The search query to explain against
doc_id	string	required	Document ID, e.g. "doc_42" or "42"

Raw 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

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.

Parameters4

query	string	required	The search query
domain	string	optional	Filter by knowledge domain (e.g. MEDICINE, SCIENCE, TECHNOLOGY, HISTORY, LAW, CODE). Case-insensitive.
limit	integer	optional	Max results to return
offset	integer	optional	Offset for pagination

Raw 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

string

required

Stable knowledge entry id, e.g. eng_... or soc_...

Raw 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

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.

Parameters1

string

required

Stable knowledge entry id

Raw 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

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.

Parameters2

id	string	required	Stable knowledge entry id
content_hash	string	required	The content_hash from a previous fetch/cite

Raw 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

id	string	required	Stable knowledge entry id, e.g. eng_... or soc_...
limit	integer	optional	Max related entries

Raw 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

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.

Parameters2

query	string	required	The name/term/alias to resolve
limit	integer	optional	Max alternative candidates

Raw 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

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.

Parameters3

queries	array	required	1–10 queries
domain	string	optional	Optional domain filter applied to all queries
limit	integer	optional	Max results per query

Raw 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

Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).

Parameters2

query	string	optional	Optional query to get coverage/state stats for
domain	string	optional	Optional domain filter (with query)

Raw 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

id	string	required	Stable knowledge entry id, e.g. eng_... or soc_...
limit	integer	optional	Max cross-domain analogs (one per domain)

Raw 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#"
}

Install

Tools (16)

coldstate_searchcoldstate_list_indexescoldstate_browse_documentscoldstate_explaincoldstate_search_globalcoldstate_domainscoldstate_fetchcoldstate_cite

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://cold-api.coldstate.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "knowledge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cold-api.coldstate.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.coldstate/knowledge Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

coldstate_search

coldstate_list_indexes

coldstate_browse_documents

coldstate_explain

coldstate_search_global

coldstate_domains

coldstate_fetch

coldstate_cite

coldstate_verify

coldstate_snapshot

coldstate_related

coldstate_resolve

coldstate_batch_search

coldstate_stats

coldstate_capabilities

coldstate_isomorph

Install

Remote endpoint

Related servers