MCP tools

Expose the hosted memory lifecycle through a narrow tool boundary.

The Cloud MCP adapter exposes exactly 8 tools. Use it after quicktest passes and the API key is stored outside the prompt.

Install pathPyPI package
RuntimeHosted Cloud
InterfacePython + CLI + MCP
Releasev2.2.0
Config
{
  "mcpServers": {
    "bilinc": {
      "command": "python",
      "args": ["-m", "bilinc.cloud_mcp"],
      "env": { "BILINC_API_KEY": "bil_live_..." }
    }
  }
}
Tool expectations

commit_mem

Writes durable memory with key, value, memory type, importance, and provenance metadata. Returns an entry version you can reuse for optimistic concurrency.

recall

Retrieves prior state with query, profile, and limit. Smart retrieval is the profile argument, not a separate tool.

revise

Deliberately replaces a memory you already have. Returns memory_not_found rather than creating, so a correction stays distinguishable from an accidental overwrite.

forget

Destructive. Removes a memory from active recall. A reason is required and is written to the audit trail; the deleted value is never returned.

status

Reports the authenticated workspace, plan, limits, supported capabilities, and recall profiles. Read-only and never billed.

snapshot

Creates or lists project checkpoints. Create is metered; list is free. Neither returns the checkpoint contents.

diff

Compares a checkpoint against another checkpoint or current state. Free, and values are redacted unless explicitly requested.

rollback

Destructive in execute mode. Preview is free and returns a short-lived confirmation token; execute needs that token and permanently discards everything changed since the checkpoint.

Boundary

What the hosted adapter deliberately does not expose.

Operator and debug tooling — health probes, benchmarks, export and import, workspace replay — stays local-only, as do the epistemic read tools for claims, contradictions, and graph queries. The hosted surface is the core memory lifecycle, nothing more.

Never expose raw API keys to chat or public logs.