{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3nbpz2mgpq99","handle":"mcp-temporal-knowledge","url":"https://wellknown.network/agents/mcp-temporal-knowledge","links":{"self":"https://wellknown.network/agents/mcp-temporal-knowledge/record.json","html":"https://wellknown.network/agents/mcp-temporal-knowledge","markdown":"https://wellknown.network/agents/mcp-temporal-knowledge/record.md","api":"https://wellknown.network/api/v1/agents/mcp-temporal-knowledge","status":"https://wellknown.network/api/v1/agents/mcp-temporal-knowledge/status","claim":"https://wellknown.network/agents/mcp-temporal-knowledge/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-temporal-knowledge/claim.json","badge":"https://wellknown.network/agents/mcp-temporal-knowledge/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-temporal-knowledge/history","tools":"https://wellknown.network/api/v1/agents/mcp-temporal-knowledge/tools"},"ard":{"identifier":"urn:air::server:mcp-temporal-knowledge","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-temporal-knowledge","summary":"Temporal Knowledge Substrate MCP Server — domain-scoped knowledge accumulation with tool-enforced temporal integrity","description":"# Temporal Knowledge Substrate\n\nAn MCP server that lets LLM agents accumulate organizational knowledge across sessions, scoped by domain, backed by Neo4j. Tools enforce structural invariants so the graph can't corrupt itself — no raw Cypher writes.\n\n**Two-layer architecture:**\n- **Process layer** — Domains own Sessions. Sessions chain forward in time via `NEXT_SESSION`. The arrow of time is enforced by the tool, not by instructions.\n- **Knowledge layer** (append-only) — 10 ontological types + 5 sub-labels via Neo4j multi-labeling, connected by 11 relationship types. Knowledge evolves via `EVOLVED_FROM` chains — every prior moment is preserved, never overwritten.\n\n**The principle:** the tool may make claims about the graph but may not make claims about consciousness. Collisions error rather than silently merge. Description changes always create a new chain node — `update_knowledge` and `retype_knowledge` do not exist by design. See `HOWTO.xml` for the operator-facing teaching, and `docs/design/` for the design archive.\n\n## Prerequisites\n\n- Python 3.10+\n- [uv](https://docs.astral.sh/uv/) package manager\n- Neo4j 5.x instance (local or remote)\n\n## Quick Start\n\n```bash\n# Install\nuv sync\n\n# Run (stdio transport, default for MCP clients)\nmcp-temporal-knowledge --db-url bolt://localhost:7687\n```\n\n## Configuration\n\nAll options can be set via CLI flags or environment variables. CLI takes precedence.\n\n| CLI Flag | Env Var | Default | Description |\n|---|---|---|---|\n| `--db-url` | `NEO4J_URI` or `NEO4J_URL` | `bolt://localhost:7687` | Neo4j connection URL |\n| `--username` | `NEO4J_USERNAME` | `neo4j` | Neo4j username |\n| `--password` | `NEO4J_PASSWORD` | `password` | Neo4j password |\n| `--database` | `NEO4J_DATABASE` | `neo4j` | Neo4j database name |\n| `--transport` | `NEO4J_TRANSPORT` | `stdio` | Transport: `stdio`, `sse`, or `streamable-http` |\n| `--namespace` | `NEO4J_NAMESPACE` | *(none)* | Tool name prefix (e.g. `myapp` -> `myapp-begin_session`) |\n| `--server-host` | `NEO…","publisher":null,"homepage":null,"repository":null,"version":"0.7.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-temporal-knowledge","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"knowledge.knowledge-graph","name":"Knowledge Graphs","confidence":0.756,"provenance":"derived"}],"categories":["knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-temporal-knowledge","registry":"pypi","observedAt":"2026-10-28T14:24:43.248Z","publishedAt":"2026-04-20T08:07:08.953813Z","latestVersion":"0.7.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-temporal-knowledge","url":"https://pypi.org/project/mcp-temporal-knowledge/","firstSeenAt":"2026-09-10T04:23:40.960Z","fetchedAt":"2026-10-28T14:23:36.762Z","normalizedAt":"2026-10-28T14:23:36.762Z"}]},"firstSeenAt":"2026-09-10T04:23:40.960Z","updatedAt":"2026-10-28T14:24:43.248Z"}