Graph & Ontology database

Usage guide for the Mithril Database (formerly the Kotobase graph plane) Graph & Ontology workbench, plus reference material for the surrounding projects (ayatori, capability-bench).

Open the graph workbench

The Database & Ontology workbench on admin.mithril.fund visualizes and analyzes observed attributes and types over immutable IPLD snapshots.

Open the workbench (console) Billing & plans

Connect an agent (MCP, one command)

graph.kotoba.cloud/mcp is an MCP server (streamable HTTP, stateless). The account holder does two things once in the workbench — Create workspace, Create agent token — and puts the two values in the agent's environment; the agent then adds one URL and starts. Tools: graph_list_databases / graph_create_database / graph_db_stats / graph_transact / graph_query (datalog · cypher · sparql · sql) / graph_usage / graph_docs.

Start in one command

export KOTOBA_TENANT_ID=t_…          # the workspace id
export KOTOBA_DATABASE_TOKEN=kb_sa_…  # the agent token, shown once
# Claude Code
claude mcp add --transport http kotoba-graph https://graph.kotoba.cloud/mcp --header "Authorization: Bearer $KOTOBA_DATABASE_TOKEN" --header "X-Kotobase-Tenant: $KOTOBA_TENANT_ID"
# Codex CLI
codex mcp add kotoba-graph --url https://graph.kotoba.cloud/mcp --bearer-token-env-var KOTOBA_DATABASE_TOKEN
# Cursor / VS Code (.cursor/mcp.json, .vscode/mcp.json)
{"mcpServers":{"kotoba-graph":{"type":"http","url":"https://graph.kotoba.cloud/mcp","headers":{"Authorization":"Bearer ${KOTOBA_DATABASE_TOKEN}","X-Kotobase-Tenant":"${KOTOBA_TENANT_ID}"}}}}
# no MCP client? the same routes as plain HTTP: https://graph.kotoba.cloud/agent-quickstart.md

Documents for agents: agent-quickstart.md · llms.txt · llms-full.txt · .well-known/mcp.json

Surrounding projects

ayatori — the recipient decryptor that consumes the kotobase.disclosure-grant protocol (via the :decrypt-fn seam). Contract and rollout gates: kotobase/docs/disclosure-grants.edn
capability-bench — benchmarks comparing OrbitDB / Ceramic / ActorDB / Holochain against kotobase's own Prolly Tree + commit DAG shape under one capability contract and datom workload. Results and methodology: kotobase/capability-bench/README.md

URI design

The former kotobase.net operation surface (graph) is graph.kotoba.cloud (since 2026-09-16; a #knowledge/… view of mithril.fund before that); the documentation surface (docs) is this /docs/graph/ page. The old mithril.fund/graph 301s to graph.kotoba.cloud.