MCP Tools

Available MCP tools for AI assistant integration.

The MCP server exposes the following tools, each mapping directly to a Kremis HTTP API endpoint.

Tool	HTTP Equivalent	Description
kremis_ingest	POST /signal	Ingest a signal (entity, attribute, value)
kremis_lookup	POST /query (lookup)	Look up an entity by ID
kremis_traverse	POST /query (traverse_filtered)	Traverse graph from a node; optional top_k limit
kremis_path	POST /query (strongest_path)	Find the strongest path between two nodes
kremis_intersect	POST /query (intersect)	Find nodes connected to all input nodes
kremis_status	GET /status	Get graph statistics
kremis_properties	POST /query (properties)	Get properties of a node
kremis_retract	POST /signal/retract	Decrement edge weight between two entities
kremis_hash	GET /hash	Get the canonical BLAKE3 hash of the graph
kremis_certify	POST /certify (lookup)	Verifiable Query Certificate: reproducible proof of a fact, or proof of absence

Tool Details

kremis_ingest

Add an entity or record a relationship.

{
  "entity_id": 1,
  "attribute": "name",
  "value": "Alice"
}

kremis_lookup

Look up a node by entity ID.

{
  "entity_id": 1
}

kremis_traverse

Traverse the graph from a starting node. Optionally limit results to the K highest-weight edges.

{
  "node_id": 0,
  "depth": 3,
  "top_k": 10
}

top_k is optional. When provided and greater than 0, only the K highest-weight edges are returned (sorted by weight descending). Omit for no limit.

kremis_path

Find the strongest path between two nodes.

{
  "start": 0,
  "end": 5
}

kremis_intersect

Find common connections between nodes.

{
  "nodes": [0, 1, 2]
}

kremis_status

No parameters required. Returns node count, edge count, and density.

kremis_properties

Get all properties of a node.

{
  "node_id": 0
}

kremis_retract

Decrement the weight of an edge between two entities. If the edge does not exist, returns an error. The weight decrements by 1, floored at 0 (never negative).

{
  "from_entity": 1,
  "to_entity": 2
}

kremis_hash

No parameters required. Returns the canonical BLAKE3 hash of the current graph state. Use to verify graph integrity or detect state changes between sessions.

kremis_certify

Produce a Verifiable Query Certificate for an entity lookup. Returns the grounding verdict, the canonical state hash, and a base64 certificate a third party re-derives offline. When the entity is absent, the result is a proof of absence. See Proof-Carrying Knowledge.

{
  "entity_id": 1
}