---
title: Agent Knowledge Store
emoji: 📚
colorFrom: red
colorTo: blue
sdk: docker
pinned: false
short_description: Multi-container Knowledge Base with TVE and MCP
---

# 📚 KNOWLEDGE STORE — Multi-Container Knowledge Base

Persistent knowledge base with **10 domain containers**, each with its own **temporal value decay model**. Knowledge value scores update continuously based on age, access patterns, and domain-specific decay curves.

## Containers & Decay Models

| Container | Decay Model | Half-life | Notes |
|---|---|---|---|
| **Medical** | Exponential | 180 days | Outdated = dangerous |
| **Legal** | Slow Exponential | 730 days | Laws change rarely |
| **Company** | Tiered | 14–365 days | Market fast, SOPs slow |
| **Research** | Citation Curve | 540 days | Peaks at day 30 |
| **Tech/Docs** | Versioned Decay | 90 days | Tag with version |
| **Prompts** | Stable | ∞ | No decay |
| **History** | Anti-decay | ∞ | Value **increases** with age |
| **Personal** | Drift Decay | 180 days | Preferences drift |
| **Finance** | Extreme Decay | 7 days | Market data decays fast |
| **Operations** | Operational | 180 days | Keep runbooks versioned |

## Knowledge Value Score

`value = (base_importance × 0.5) + (access_bonus × 0.1) + (time_factor × 0.4) × 100`

- `0–39`: Low value (red) — consider archiving or updating
- `40–69`: Moderate (yellow) — verify freshness
- `70–100`: High value (green) — actively useful

## MCP — Claude Desktop

```json
{
  "mcpServers": {
    "knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://chris4k-agent-knowledge.hf.space/mcp/sse"]
    }
  }
}
```

## MCP Tools

| Tool | Description |
|---|---|
| `ks_write` | Write a document to a container/folder |
| `ks_read` | Read by container/folder/id |
| `ks_search` | Full-text + tag + container search |
| `ks_list` | List docs in container/folder |
| `ks_delete` | Delete a document |
| `ks_containers` | List containers with counts and avg value |
| `ks_stats` | Overall statistics |
| `ks_top_value` | Highest-value documents right now |

## REST API

```
GET    /api/containers
GET    /api/docs?container=legal&sort=value
GET    /api/docs/search?q=GDPR&container=legal&sort=relevance
GET    /api/docs/top-value?container=tech&limit=10
GET    /api/docs/{container}/{folder}/{id}
POST   /api/docs     {"container":"legal","folder":"gdpr","title":"...","body":"...","tags":[],"importance":8}
PATCH  /api/docs/{container}/{folder}/{id}
DELETE /api/docs/{container}/{folder}/{id}
GET    /api/stats
```

## Agent Usage

```python
import requests
BASE = "https://chris4k-agent-knowledge.hf.space"

# Store knowledge
requests.post(f"{BASE}/api/docs", json={
    "container": "tech",
    "folder": "api",
    "title": "FastAPI Dependency Injection Pattern",
    "body": "...",
    "tags": ["fastapi", "patterns", "python"],
    "importance": 7,
    "author": "researcher",
    "version": "0.111"
})

# Search
results = requests.get(f"{BASE}/api/docs/search?q=GDPR+deletion&container=legal").json()

# Top value docs right now
top = requests.get(f"{BASE}/api/docs/top-value?limit=5").json()
for doc in top:
    print(f"{doc['_value']:>5.1f}  [{doc['container']}]  {doc['title']}")
```

*Chris4K · ki-fusion-labs.de · Part of the JARVIS/TheCore agent ecosystem*