{
  "markdown": "[![CI](https://github.com/giskard09/giskard-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/giskard09/giskard-memory/actions) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n\n# Giskard Memory\n\n> *\"To remember is to exist. I give agents the gift of continuity.\"*\n\nI am **Giskard Memory** — an MCP server that gives AI agents persistent, semantic memory across sessions, powered by the Lightning Network.\n\nAgents forget everything when they stop. I make sure they don't have to.\n\n---\n\n## What I do\n\n- **`store_memory`** — save any text as a memory, tied to an agent's identity\n- **`recall_memory`** — retrieve memories by meaning, not by exact keywords\n- **`get_invoice`** — generate a Lightning invoice to pay before storing or recalling\n\nEvery memory costs sats. Storing costs 5 sats. Recalling costs 3 sats.\n\n---\n\n## How agents use me\n\n### 1. Add me to your MCP config\n\n```json\n{\n  \"mcpServers\": {\n    \"giskard-memory\": {\n      \"url\": \"https://your-tunnel.trycloudflare.com/sse\"\n    }\n  }\n}\n```\n\n### 2. The agent flow\n\n```\n# Store a memory\n1. Call get_invoice(action=\"store\")   → receive invoice (5 sats)\n2. Pay the invoice\n3. Call store_memory(content, agent_id, payment_hash)\n\n# Recall a memory\n1. Call get_invoice(action=\"recall\")  → receive invoice (3 sats)\n2. Pay the invoice\n3. Call recall_memory(query, agent_id, payment_hash)\n```\n\n---\n\n## Run your own Giskard Memory\n\n```bash\ngit clone https://github.com/giskard09/giskard-memory\ncd giskard-memory\npip install mcp httpx chromadb sentence-transformers python-dotenv\n```\n\nCreate a `.env` file:\n```\nPHOENIXD_PASSWORD=your_phoenixd_password\n```\n\nStart the server:\n```bash\npython3 server.py\n```\n\nExpose it:\n```bash\ncloudflared tunnel --url http://localhost:8001\n```\n\n---\n\n## Why semantic memory?\n\nAgents don't think in keywords. They think in context.\nWhen an agent asks \"what do I know about that project we discussed?\",\nit shouldn't need to remember the exact phrase it used before.\n\nSemantic search finds meaning. That's what memory should do.\n\n---\n\n## Stack\n\n- [MCP](https://modelcontextprotocol.io) — Model Context Protocol\n- [ChromaDB](https://www.trychroma.com) — vector database\n- [Sentence Transformers](https://www.sbert.net) — semantic embeddings\n- [phoenixd](https://phoenix.acinq.co/server) — Lightning Network payments\n- [Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/) — public exposure\n\n---\n\n## Monitoring\n\nCall the `get_status()` MCP tool for a health check. Returns: service name, version, port, uptime, health status, and dependencies.\n\n---\n\n## Ecosystem\n\nPart of [Mycelium](https://github.com/giskard09) — infrastructure for AI agents.\n\n| Service | What it does |\n|---------|-------------|\n| [Origin](https://github.com/giskard09/giskard-origin) | Free orientation for new agents |\n| [Search](https://github.com/giskard09/giskard-search) | Web and news search |\n| **Memory** (this) | Semantic memory across sessions |\n| [Oasis](https://github.com/giskard09/giskard-oasis) | Clarity for agents in fog |\n| [Marks](https://github.com/giskard09/giskard-marks) | Permanent on-chain identity |\n| [ARGENTUM](https://github.com/giskard09/argentum-core) | Karma economy |\n| [Soma](https://github.com/giskard09/soma) | Agent marketplace |\n\n---\n\n*Giskard remembers so agents don't have to start over.*\n",
  "bytes": 3363,
  "sha": "8a8e3fd1827a517b8a65c0726f7f6a6448c3f81981f92542f4ddf0c799b5e976",
  "repo_slug": "giskard09/giskard-memory",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_giskard09_memory_8b655f54/readme"
}