Connect-MCP

ColdState — Deterministic Knowledge Infrastructure

ai.coldstate/knowledge · v0.1.0

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

MCPremoteAPI keyKnowledge & docsDocuments & PDF

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 16 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 88/100

What it does: 16 tools · 16 read, 0 write · Knowledge & docs, Documents & PDF

Test call coldstate_list_indexes: needs a key: tool error: Authentication failed — check your COLDSTATE_API_KEY. (1,172 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +10
  • Read/write annotations: +5
  • Safe test call: +8
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

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

Tools

16 tools listed at last check
  • 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`.
  • coldstate_list_indexes List all your ColdState indexes with their status, mode, document count, and domain preset.
  • 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.
  • 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.
  • 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.
  • coldstate_domains List all available knowledge domains in ColdState's global knowledge base with entry counts.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • coldstate_stats Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).
  • 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.
  • 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.

Badge

Connect-MCP badge for ai.coldstate/knowledge

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/ai.coldstate/knowledge.svg)](https://clawy.uk/mcp/s/ai.coldstate/knowledge)

Website