ColdState — Deterministic Knowledge Infrastructure

by coldstate.ai · remote · no sign-in to list tools · v0.1.0 · published by ai.coldstate

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

Changes · 5

Compare Registry entry

16 tools: 5 change things and 11 only read.

Scanned Oct 21, 2026

Deletes or cancels0Claude Code: deny
Can't be undone0Claude Code: ask
Changes things5Claude Code: ask: see these tools
Only reads11Claude Code: allow: see these tools

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http knowledge https://cold-api.coldstate.ai/mcp --header 'Authorization: <your-authorization>'

Findings

Matches of fixed checks, with the text they matched.

1 warn

Warncoldstate_batch_search
The server marks "coldstate_batch_search" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
Matched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}; The name "coldstate_batch_search" says "search": a word for reading.
What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

16 tools

Changes things 5Creates or changes something that can be changed back.Claude Code: ask

coldstate_batch_searchRun several knowledge-base queries in one call against a single consistent kb_snapshot.1 finding
Why it is in this group
- The name "coldstate_batch_search" says "search": a word for reading.
- The description's first verb is "run": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
  The server marks "coldstate_batch_search" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
  Matched text
  annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true}; The name "coldstate_batch_search" says "search": a word for reading.
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- title: Batch Search
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_capabilitiesMachine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.
Annotations the server declares
- title: Capabilities
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_isomorphCross-domain structural analog: given a knowledge entry id, find its closest structural twin in each OTHER domain ("same structure, different domain").No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
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.
Annotations the server declares
- title: Cross-domain Analog
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_statsDeterministic statistics.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).
Annotations the server declares
- title: Stats
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_verifyVerify a previously-cited knowledge fact is unchanged.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
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.
Annotations the server declares
- title: Verify Fact
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true

Only reads 11Looks things up and changes nothing.Claude Code: allow

coldstate_browse_documentsBrowse documents in a ColdState index.No findings
Why it is in this group
- The name "coldstate_browse_documents" says "browse": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: Browse Documents
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_citeGet a canonical, reproducible citation for a knowledge entry by id (title, domain, source, content_hash, kb_snapshot).No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: Cite Entry
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_domainsList all available knowledge domains in ColdState's global knowledge base with entry counts.No findings
Why it is in this group
- The description's first verb is "list": a word for reading.
Description, as the server wrote it
List all available knowledge domains in ColdState's global knowledge base with entry counts.
Annotations the server declares
- title: List Domains
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_explainExplain why a specific document ranked for a query.No findings
Why it is in this group
- The name "coldstate_explain" says "explain": a word for reading.
Description, as the server wrote it
Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.
Annotations the server declares
- title: Explain Score
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_fetchFetch a single knowledge-base entry verbatim by its stable id (e.g.No findings
Why it is in this group
- The name "coldstate_fetch" says "fetch": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: Fetch Entry
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_list_indexesList all your ColdState indexes with their status, mode, document count, and domain preset.No findings
Why it is in this group
- The name "coldstate_list_indexes" says "list": a word for reading.
Description, as the server wrote it
List all your ColdState indexes with their status, mode, document count, and domain preset.
Annotations the server declares
- title: List Indexes
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_relatedFind knowledge entries deterministically related to a given entry id via ColdState's concept-cluster graph.No findings
Why it is in this group
- The description's first verb is "find": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: Related Entries
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_resolveResolve a name, alias, or surface form to its canonical ColdState knowledge entry (id + title).No findings
Why it is in this group
- The name "coldstate_resolve" says "resolve": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: Resolve Entity
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_searchSearch a ColdState index by collection name or index ID.No findings
Why it is in this group
- The name "coldstate_search" says "search": a word for reading.
Description, as the server wrote it
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`.
Annotations the server declares
- title: Search
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_search_globalSearch ColdState's global knowledge base (48.4M+ entries across 35 domains including SCIENCE, MEDICINE, TECHNOLOGY, HISTORY, etc).No findings
Why it is in this group
- The name "coldstate_search_global" says "search": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: Search Global Knowledge
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
coldstate_snapshotGet the current knowledge-base snapshot/version id.No findings
Why it is in this group
- The name "coldstate_snapshot" says "snapshot": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: KB Snapshot
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http knowledge https://cold-api.coldstate.ai/mcp --header 'Authorization: <your-authorization>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__knowledge__coldstate_search",
      "mcp__knowledge__coldstate_list_indexes",
      "mcp__knowledge__coldstate_browse_documents",
      "mcp__knowledge__coldstate_explain",
      "mcp__knowledge__coldstate_search_global",
      "mcp__knowledge__coldstate_domains",
      "mcp__knowledge__coldstate_fetch",
      "mcp__knowledge__coldstate_cite",
      "mcp__knowledge__coldstate_snapshot",
      "mcp__knowledge__coldstate_related",
      "mcp__knowledge__coldstate_resolve"
    ],
    "ask": [
      "mcp__knowledge__coldstate_verify",
      "mcp__knowledge__coldstate_batch_search",
      "mcp__knowledge__coldstate_stats",
      "mcp__knowledge__coldstate_capabilities",
      "mcp__knowledge__coldstate_isomorph"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as knowledge. Review it before you use it.

Keep track

Get told when this server's tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/ai.coldstate/knowledge/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Anlyon alternative

5 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Compare with other servers for the same product.

Source: MCP Registry. Synced Oct 21, 2026, 17:41 UTC.

For agents: Markdown · JSON · report this listing