ColdState — Deterministic Knowledge Infrastructure

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "ColdState — Deterministic Knowledge Infrastructure": {
      "url": "https://cold-api.coldstate.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (16)

• coldstate_search read-only

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

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_list_indexes read-only

  List all your ColdState indexes with their status, mode, document count, and domain preset.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_browse_documents read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_explain read-only

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

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_search_global read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_domains read-only

  List all available knowledge domains in ColdState's global knowledge base with entry counts.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_fetch read-only

  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.

  Parameters:

  • id (required) — string — Stable knowledge entry id, e.g. eng_... or soc_...

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_cite read-only

  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.

  Parameters:

  • id (required) — string — Stable knowledge entry id

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_verify read-only

  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.

  Parameters:

  • id (required) — string — Stable knowledge entry id
  • content_hash (required) — string — The content_hash from a previous fetch/cite

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_snapshot read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_related read-only

  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.

  Parameters:

  • id (required) — string — Stable knowledge entry id, e.g. eng_... or soc_...
  • limit — integer — Max related entries

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_resolve read-only

  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.

  Parameters:

  • query (required) — string — The name/term/alias to resolve
  • limit — integer — Max alternative candidates

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_batch_search read-only

  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.

  Parameters:

  • queries (required) — array — 1–10 queries
  • limit — integer — Max results per query
  • domain — string — Optional domain filter applied to all queries

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_stats read-only

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

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_capabilities read-only

  Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• coldstate_isomorph read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.