ColdState — Deterministic Knowledge Infrastructure

ai.coldstatePublished by coldstate.aiOfficial publisherv0.1.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Deterministic knowledge base access: search, fetch, cite and verify entries from a 48M-entry, 35-domain corpus, plus your own zero-knowledge indexes.

What you can do
  • Search the global knowledge base by query and optional domain, or search your own indexes by collection name or index ID
  • Fetch, cite and verify knowledge entries by stable id, with content hashes and snapshot ids for reproducible citation
  • Resolve names or aliases to canonical entries, find related entries via a concept-cluster graph, and find cross-domain structural analogs
  • Run batch queries against one consistent snapshot, and get deterministic statistics or the current snapshot id
  • List your indexes and browse their documents as ref_ids with state classifications, and explain why a document ranked for a query
  • Read a machine-readable manifest of tools, domains, determinism guarantees and…
When to use it
Useful when an assistant needs citable, reproducible facts rather than open web search, or when answers must be re-verifiable later against a pinned snapshot. Also fits cross-domain analogy finding and auditing why a document matched a query.
Requirements
Remote streamable HTTP endpoint; no local package. Requires a bearer API key sent in the Authorization header; a free tier is available at signup. Network access to the provider is needed.
Before you install
The API key is a secret sent in the Authorization header and should be kept out of logs and shared configs. Indexes are zero-knowledge, so document text is not returned and ref_ids must be mapped back to your own content. Search queries and index names are sent to the provider.

Installation

In SourceWeft

  1. Open ColdState — Deterministic Knowledge Infrastructure in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.coldstate%2Fknowledge/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "coldstate-deterministic-knowledge-infras": {
      "type": "http",
      "url": "https://cold-api.coldstate.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Tools

16

coldstate_list_indexes

List Indexes

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

Takes no parameters.

coldstate_browse_documents

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.

Parameterslimitoffsetindex_idrequired

coldstate_explain

Explain Score

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

Parametersqueryrequireddoc_idrequiredindex_idrequired

coldstate_search_global

Search Global Knowledge

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.

Parameterslimitqueryrequireddomainoffset

coldstate_domains

List Domains

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

Takes no parameters.

coldstate_fetch

Fetch Entry

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.

Parametersidrequired

coldstate_cite

Cite Entry

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.

Parametersidrequired

coldstate_verify

Verify Fact

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.

Parametersidrequiredcontent_hashrequired

coldstate_snapshot

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

Takes no parameters.

coldstate_resolve

Resolve Entity

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.

Parameterslimitqueryrequired

coldstate_stats

Stats

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

Parametersquerydomain

coldstate_capabilities

Capabilities

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

Takes no parameters.

coldstate_isomorph

Cross-domain Analog

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.

Parametersidrequiredlimit

Version history

1
  1. v0.1.0LatestSep 30, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.