> ## Documentation Index
> Fetch the complete documentation index at: https://kremis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```json theme={null}
{
  "entity_id": 1,
  "attribute": "name",
  "value": "Alice"
}
```

### kremis\_lookup

Look up a node by entity ID.

```json theme={null}
{
  "entity_id": 1
}
```

### kremis\_traverse

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

```json theme={null}
{
  "node_id": 0,
  "depth": 3,
  "top_k": 10
}
```

`depth` is optional and defaults to 2; the maximum accepted by the graph engine is 100.

`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.

```json theme={null}
{
  "start": 0,
  "end": 5
}
```

### kremis\_intersect

Find common connections between nodes.

```json theme={null}
{
  "nodes": [0, 1, 2]
}
```

### kremis\_status

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

### kremis\_properties

Get all properties of a node.

```json theme={null}
{
  "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).

```json theme={null}
{
  "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](/concepts/proof-carrying-knowledge).

```json theme={null}
{
  "entity_id": 1
}
```