Deterministic knowledge for AI agents: search, fetch, cite and verify a 48M-entry knowledge base.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <COLDSTATE_API_KEY>. Get a key (free tier available) at https://services.coldstate.ai/signup
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh 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.
1–10 queries
Max results per query
Optional domain filter applied to all queries
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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results per query |
| domain | string | Optional domain filter applied to all queries |
| queries* | array | 1–10 queries |
{
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max documents to return |
| offset | integer | Offset for pagination |
| index_id* | string | Index ID, e.g. idx_... |
{
"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_..."
}
}
}Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | string | Stable knowledge entry id |
{
"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"
}
}
}List all available knowledge domains in ColdState's global knowledge base with entry counts.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.
| Argument | 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_... |
{
"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_..."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | string | Stable knowledge entry id, e.g. eng_... or soc_... |
{
"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_..."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | string | Stable knowledge entry id, e.g. eng_... or soc_... |
| limit | integer | Max cross-domain analogs (one per domain) |
{
"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)"
}
}
}List all your ColdState indexes with their status, mode, document count, and domain preset.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | string | Stable knowledge entry id, e.g. eng_... or soc_... |
| limit | integer | Max related entries |
{
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max alternative candidates |
| query* | string | The name/term/alias to resolve |
{
"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"
}
}
}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`.
| Argument | 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) |
{
"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)"
}
}
}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.
| Argument | 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 |
{
"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"
}
}
}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 arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).
| Argument | Type | Description |
|---|---|---|
| query | string | Optional query to get coverage/state stats for |
| domain | string | Optional domain filter (with query) |
{
"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)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | string | Stable knowledge entry id |
| content_hash* | string | The content_hash from a previous fetch/cite |
{
"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"
}
}
}