# Lore MCP server

> Provides a cross-agent memory layer that stores, connects, and retrieves knowledge using semantic search and knowledge graphs.

- Repository: https://github.com/agentkitai/lore
- Page: https://hostedmcp.org/servers/agentkitai/lore
- Transport: stdio
- Stars: 10
- License: MIT
- Latest version: 1.4.2

## Install

### Claude Code

```sh
claude mcp add lore -- uvx lore-sdk
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "lore": {
      "command": "uvx",
      "args": [
        "lore-sdk"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "lore": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "lore-sdk"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "lore": {
      "command": "uvx",
      "args": [
        "lore-sdk"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.lore]
command = "uvx"
args = ["lore-sdk"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "lore": {
      "command": "uvx",
      "args": [
        "lore-sdk"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `LORE_API_KEY` | no | no |  |
| `LORE_API_URL` | no | no |  |

## Tools (46)

- `remember`
- `recall`
- `forget`
- `list_memories`
- `stats`
- `upvote_memory`
- `downvote_memory`
- `graph_query`
- `entity_map`
- `related`
- `extract_facts`
- `list_facts`
- `conflicts`
- `classify`
- `enrich`
- `consolidate`
- `ingest`
- `github_sync`
- `check_freshness`
- `as_prompt`
- `add_conversation`
- `recent_activity`
- `topics`
- `topic_detail`
- `export`
- `snapshot`
- `snapshot_list`
- `save_snapshot`
- `review_digest`
- `review_connection`
- `on_this_day`
- `suggest`
- `remember_observation`
- `search`
- `get_memories`
- `timeline`
- `promote_memory`
- `demote_memory`
- `supersede`
- `list_at_time`
- `consolidate_memories`
- `provenance`
- `supersession_chain`
- `facts_at_time`
- `supersede_fact`
- `fact_supersession_chain`

## FAQ

### How does Lore work with existing AI agents?

Lore works via hooks that automatically capture conversation context and inject relevant session history into prompts without requiring agent cooperation or code changes.

### Can I use Lore with Claude Code or Cursor?

Yes, Lore provides one-command setup for major AI coding agents including Claude Code, Cursor, OpenClaw, and Codex.

### Does Lore delete old information when it is corrected?

No, Lore uses a bi-temporal system where memories and facts are corrected by superseding them rather than deleting them, creating an auditable trail.

### How can I visualize my knowledge base?

Lore includes a web-based UI featuring an interactive D3 force-directed graph for exploring entities, topic clusters, and search results.