Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "knowledge": {
      "type": "http",
      "url": "https://cold-api.coldstate.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${KNOWLEDGE_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http knowledge https://cold-api.coldstate.ai/mcp --header "Authorization: Bearer ${KNOWLEDGE_TOKEN}"

[mcp_servers.knowledge]
url = "https://cold-api.coldstate.ai/mcp"
bearer_token_env_var = "KNOWLEDGE_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "knowledge": {
      "type": "remote",
      "url": "https://cold-api.coldstate.ai/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:KNOWLEDGE_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "knowledge": {
      "type": "http",
      "url": "https://cold-api.coldstate.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${KNOWLEDGE_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=knowledge&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29sZC1hcGkuY29sZHN0YXRlLmFpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0tOT1dMRURHRV9UT0tFTn0ifX0%3D"
}

{
  "servers": {
    "knowledge": {
      "type": "http",
      "url": "https://cold-api.coldstate.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${KNOWLEDGE_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "knowledge": {
      "httpUrl": "https://cold-api.coldstate.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${KNOWLEDGE_TOKEN}"
      }
    }
  }
}

extensions:
  "knowledge":
    enabled: true
    name: "knowledge"
    type: streamable_http
    uri: "https://cold-api.coldstate.ai/mcp"
    headers:
      "Authorization": "Bearer ${KNOWLEDGE_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${KNOWLEDGE_TOKEN}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations16 of 16 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: coldstate_fetch (openWorldHint); coldstate_verify (openWorldHint); coldstate_snapshot (openWorldHint); …
pass
tools.token_costabout 2,419 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

16 tools, about 2,419 tokens to load them all · tool set 89cd87bf3412 · checked 2026-10-19 10:52 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 82 / 100

no-repository

provenance55

liveness99

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-97% +updated-19d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://cold-api.coldstate.ai/mcp` streamable-http	api_key `${KNOWLEDGE_TOKEN}`	yes	97%	301 ms	2025-11-25	2026-10-19

Tools (16)

`coldstate_batch_search`read-only	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_browse_documents`read-only	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_capabilities`read-only	Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.
`coldstate_cite`read-only	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_domains`read-only	List all available knowledge domains in ColdState's global knowledge base with entry counts.
`coldstate_explain`read-only	Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.
`coldstate_fetch`read-only	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_isomorph`read-only	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.
`coldstate_list_indexes`read-only	List all your ColdState indexes with their status, mode, document count, and domain preset.
`coldstate_related`read-only	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`read-only	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_search`read-only	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_search_global`read-only	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_snapshot`read-only	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_stats`read-only	Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).
`coldstate_verify`read-only	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "ai.coldstate/knowledge",
  "_meta": {},
  "title": "ColdState — Deterministic Knowledge Infrastructure",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://cold-api.coldstate.ai/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer <COLDSTATE_API_KEY>. Get a key (free tier available) at https://services.coldstate.ai/signup"
        }
      ]
    }
  ],
  "version": "0.1.0",
  "websiteUrl": "https://services.coldstate.ai",
  "description": "Deterministic knowledge for AI agents: search, fetch, cite and verify a 48M-entry knowledge base."
}