ColdState — Deterministic Knowledge Infrastructure is an MCP server published by ai.coldstate, hosted at cold-api.coldstate.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 16 tools, including coldstate_search, coldstate_list_indexes, coldstate_browse_documents, coldstate_explain, coldstate_search_global.
Deterministic knowledge for AI agents: search, fetch, cite and verify a 48M-entry knowledge base.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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`.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return |
| query * | string | The search query |
| 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) |
None yet. Changes appear after a server's second daily check.
Inferred from the host name and headers: what a server runs on, not who runs it.
{
"name": "coldstate_search",
"description": "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`.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Max results to return"
},
"query": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The search query"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Offset for pagination"
},
"index_id": {
"type": "string",
"pattern": "^idx_[a-f0-9]+$",
"description": "Index ID to search, e.g. idx_... (mutually exclusive with collection)"
},
"collection": {
"type": "string",
"description": "Collection name to search (mutually exclusive with index_id)"
}
}
},
"annotations": {
"title": "Search",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List all your ColdState indexes with their status, mode, document count, and domain preset.
No parameters.
{
"name": "coldstate_list_indexes",
"description": "List all your ColdState indexes with their status, mode, document count, and domain preset.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"title": "List Indexes",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max documents to return |
| offset | integer | Offset for pagination |
| index_id * | string | Index ID, e.g. idx_... |
{
"name": "coldstate_browse_documents",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"index_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Max documents to return"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Offset for pagination"
},
"index_id": {
"type": "string",
"pattern": "^idx_[a-f0-9]+$",
"description": "Index ID, e.g. idx_..."
}
}
},
"annotations": {
"title": "Browse Documents",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.
| Parameter | Type | Description |
|---|---|---|
| query * | string | The search query to explain against |
| doc_id * | string | Document ID, e.g. "doc_42" or "42" |
| index_id * | string | Index ID, e.g. idx_... |
{
"name": "coldstate_explain",
"description": "Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"index_id",
"query",
"doc_id"
],
"properties": {
"query": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The search query to explain against"
},
"doc_id": {
"type": "string",
"pattern": "^\\d+$|^doc_\\d+$",
"description": "Document ID, e.g. \"doc_42\" or \"42\""
},
"index_id": {
"type": "string",
"pattern": "^idx_[a-f0-9]+$",
"description": "Index ID, e.g. idx_..."
}
}
},
"annotations": {
"title": "Explain Score",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return |
| query * | string | The search query |
| domain | string | Filter by knowledge domain (e.g. MEDICINE, SCIENCE, TECHNOLOGY, HISTORY, LAW, CODE). Case-insensitive. |
| offset | integer | Offset for pagination |
{
"name": "coldstate_search_global",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Max results to return"
},
"query": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The search query"
},
"domain": {
"type": "string",
"description": "Filter by knowledge domain (e.g. MEDICINE, SCIENCE, TECHNOLOGY, HISTORY, LAW, CODE). Case-insensitive."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Offset for pagination"
}
}
},
"annotations": {
"title": "Search Global Knowledge",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List all available knowledge domains in ColdState's global knowledge base with entry counts.
No parameters.
{
"name": "coldstate_domains",
"description": "List all available knowledge domains in ColdState's global knowledge base with entry counts.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"title": "List Domains",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Stable knowledge entry id, e.g. eng_... or soc_... |
{
"name": "coldstate_fetch",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Stable knowledge entry id, e.g. eng_... or soc_..."
}
}
},
"annotations": {
"title": "Fetch Entry",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Stable knowledge entry id |
{
"name": "coldstate_cite",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Stable knowledge entry id"
}
}
},
"annotations": {
"title": "Cite Entry",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Stable knowledge entry id |
| content_hash * | string | The content_hash from a previous fetch/cite |
{
"name": "coldstate_verify",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"content_hash"
],
"properties": {
"id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Stable knowledge entry id"
},
"content_hash": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "The content_hash from a previous fetch/cite"
}
}
},
"annotations": {
"title": "Verify Fact",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "coldstate_snapshot",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"title": "KB Snapshot",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Stable knowledge entry id, e.g. eng_... or soc_... |
| limit | integer | Max related entries |
{
"name": "coldstate_related",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Stable knowledge entry id, e.g. eng_... or soc_..."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Max related entries"
}
}
},
"annotations": {
"title": "Related Entries",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max alternative candidates |
| query * | string | The name/term/alias to resolve |
{
"name": "coldstate_resolve",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 4,
"maximum": 5,
"minimum": 1,
"description": "Max alternative candidates"
},
"query": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The name/term/alias to resolve"
}
}
},
"annotations": {
"title": "Resolve Entity",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results per query |
| domain | string | Optional domain filter applied to all queries |
| queries * | array | 1–10 queries |
{
"name": "coldstate_batch_search",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"queries"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "Max results per query"
},
"domain": {
"type": "string",
"description": "Optional domain filter applied to all queries"
},
"queries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 10,
"minItems": 1,
"description": "1–10 queries"
}
}
},
"annotations": {
"title": "Batch Search",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).
| Parameter | Type | Description |
|---|---|---|
| query | string | Optional query to get coverage/state stats for |
| domain | string | Optional domain filter (with query) |
{
"name": "coldstate_stats",
"description": "Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string",
"maxLength": 2000,
"description": "Optional query to get coverage/state stats for"
},
"domain": {
"type": "string",
"description": "Optional domain filter (with query)"
}
}
},
"annotations": {
"title": "Stats",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.
No parameters.
{
"name": "coldstate_capabilities",
"description": "Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"title": "Capabilities",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Stable knowledge entry id, e.g. eng_... or soc_... |
| limit | integer | Max cross-domain analogs (one per domain) |
{
"name": "coldstate_isomorph",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Stable knowledge entry id, e.g. eng_... or soc_..."
},
"limit": {
"type": "integer",
"default": 8,
"maximum": 35,
"minimum": 1,
"description": "Max cross-domain analogs (one per domain)"
}
}
},
"annotations": {
"title": "Cross-domain Analog",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.