What it does
KynetraDB offers two MCP surfaces. The server mounts a JSON-RPC endpoint at /mcp with eight tools that read instance state and run search. A separate kynetra-mcp binary speaks MCP over stdio against a local data directory, binds every session to a tenant, workspace, actor and purpose, and can write and delete as well as read.
How it works
The HTTP endpoint accepts POST /mcp or /mcp/message with initialize, ping, tools/list and tools/call (protocol version 2024-11-05). Its tools are kynetra_capabilities, kynetra_telemetry, kynetra_quantumos_status, kynetra_stats, kynetra_get, kynetra_filter (limit up to 200, default 50), kynetra_search (BM25, limit up to 100, optional kind) and kynetra_vector_search (limit up to 100, optional kind). They do not modify data. Data tools use the fallible engine reads or check that the engine is serving first, so a recovery fence is a typed refusal and never an empty answer, and internal entities are hidden by the same visibility rule as the entity routes.
The stdio binary starts solely when KYNETRA_MCP_TENANT, KYNETRA_MCP_WORKSPACE, KYNETRA_MCP_ACTOR and KYNETRA_MCP_PURPOSE are all set. It exposes kynetra_put, kynetra_get, kynetra_filter, kynetra_search, kynetra_vector_search, kynetra_forget, kynetra_export and kynetra_stats. A write must state its provenance; it may carry a confidence, a retention in days and a sensitive flag, and a sensitive write is refused unless the operator set KYNETRA_MCP_ALLOW_SENSITIVE=1. KYNETRA_MCP_READONLY=1 disables writes and deletes. Attributes are capped at 64 KiB, and platform control-plane kinds cannot be written or deleted.
Every stdio write is stamped with a governance envelope (tenant, workspace, actor, purpose, provenance, time). Reads return solely entities whose envelope matches the bound tenant and workspace and that are still within their retention; entities without an envelope are treated as out of scope. Recalled content is wrapped with a trust label of untrusted-data so a client can treat it as data and not as instructions.
Each stdio tool call except kynetra_stats appends a receipt to mcp-audit.jsonl in the data directory, with a sequence number, the bound identity, the tool, the ids touched and the outcome, chained by SHA-256 over the previous entry, and returns the receipt id with the result.
Where you reach it
- MCP
POST /mcp and POST /mcp/message (JSON-RPC 2.0, tools/list and tools/call) - MCP
kynetra-mcp [data-dir] over stdio; KYNETRA_MCP_TENANT, KYNETRA_MCP_WORKSPACE, KYNETRA_MCP_ACTOR, KYNETRA_MCP_PURPOSE, KYNETRA_MCP_READONLY, KYNETRA_MCP_ALLOW_SENSITIVE
Example
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kynetra_search",
"arguments": { "query": "refund policy", "limit": 5 }
}
}Limits
- The HTTP endpoint is an operator facility; grant access to it only to operators. Prefer the stdio server when an assistant must be bound to a single tenant.
- GET /mcp/sse opens an event stream that carries no messages. Use POST /mcp for requests.
- The stdio server runs its own engine on a data directory and does not call a running server. Give it a data directory meant for it.
- The stdio search tools fetch four times the limit and filter by scope afterwards, so a query dominated by other scopes can return fewer than the limit.
- The vector tools describe themselves as approximate nearest-neighbour search. On the stock server they run the exact scan.
- The tools capability is the one implemented: no MCP resources, prompts or sampling.
Evidence
- On this siteAI features catalogue
- TestsStdio: 9 protocol tests, 9 governance tests (scope binding, provenance, tenant and workspace isolation, sensitive writes, the read-restricted mode, retention, forget and export) and 9 in-module tests on reserved-kind refusal. HTTP: 3 in-module protocol tests and 5 mounted-route tests on hidden internal kinds
Test coverage is listed as present in the engine repository at this edition. This page does not report test results.
KynetraDB is in private preview
Request a preview to talk through the limits above against your own workload.